@falkenslab/moodle-driver 0.0.0-stage → 0.4.0

package/dist/moodle/gradebook.d.ts

@@ -0,0 +1,102 @@
+import type { BrowserContext, Page } from "playwright-core";
+/** The gradebook can't be read or changed: not allowed, recalculating, or a value Moodle refuses. */
+export declare class GradebookError extends Error {
+    name: string;
+}
+/** Moodle's aggregations by their constant (GRADE_AGGREGATE_*). */
+declare const AGGREGATION_CODES: {
+    readonly mean: 0;
+    readonly median: 2;
+    readonly lowest: 4;
+    readonly highest: 6;
+    readonly mode: 8;
+    readonly "weighted-mean": 10;
+    readonly "simple-weighted-mean": 11;
+    readonly "mean-with-extra-credits": 12;
+    readonly natural: 13;
+};
+export type GradeAggregation = keyof typeof AGGREGATION_CODES;
+export declare const GRADE_AGGREGATIONS: GradeAggregation[];
+export interface GradeColumn {
+    itemId: number;
+    name: string;
+    kind: "item" | "category" | "course";
+    activityId?: number;
+    activityType?: string;
+}
+export interface GraderReport {
+    columns: GradeColumn[];
+    /** Grades as the report shows them ("-" left out). */
+    rows: {
+        userId: number;
+        fullName: string;
+        grades: {
+            itemId: number;
+            grade?: string;
+        }[];
+    }[];
+}
+/** One page of the grader report, by data attributes and links, in any language. */
+export declare function readGraderReport(page: Page): Promise<GraderReport>;
+/**
+ * Everyone's grades in a course as the grader report shows them, page by page, in one group when
+ * given. People come as user id and full name only.
+ */
+export declare function graderReport(context: BrowserContext, siteUrl: string, courseId: number, { group }?: {
+    group?: number;
+}): Promise<GraderReport>;
+export interface GradebookCategory {
+    id: number;
+    /** The category's own grade item (its total). */
+    itemId: number;
+    name: string;
+    parentId?: number;
+    aggregation?: GradeAggregation;
+    maxGrade?: number;
+    /** Its weight in its parent, in percent, where the parent aggregates with weights. */
+    weight?: number;
+}
+export interface GradebookItem {
+    id: number;
+    name: string;
+    categoryId?: number;
+    /** The module ("assign", "quiz"…) for an activity's item, "manual" for one made in the gradebook. */
+    type: string;
+    maxGrade?: number;
+    /** In percent, where the category aggregates with weights. */
+    weight?: number;
+    weightOverridden: boolean;
+}
+/** The gradebook setup page's rows, by data attributes and field names. */
+export declare function readGradebookSetup(page: Page): Promise<{
+    categories: GradebookCategory[];
+    items: GradebookItem[];
+}>;
+/** A course's gradebook setup: its categories (aggregation, weights) and grade items (category, maximum, weight). */
+export declare function gradebookSetup(context: BrowserContext, siteUrl: string, courseId: number): Promise<{
+    categories: GradebookCategory[];
+    items: GradebookItem[];
+}>;
+/**
+ * Changes a grade item: moves it into a category, sets its weight (percent, overriding Natural's
+ * automatic one), or its maximum grade (a manual item's; an activity's is set in the activity).
+ * Returns the item afterwards.
+ */
+export declare function updateGradeItem(context: BrowserContext, siteUrl: string, courseId: number, itemId: number, { category, weight, maxGrade }: {
+    category?: number;
+    weight?: number;
+    maxGrade?: number;
+}): Promise<{
+    changed: string;
+    item?: GradebookItem;
+}>;
+/** Adds a grade category (at the course's top level, or inside `parentId`); returns it as the setup shows it. */
+export declare function addGradeCategory(context: BrowserContext, siteUrl: string, courseId: number, { name, aggregation, parentId }: {
+    name: string;
+    aggregation?: GradeAggregation;
+    parentId?: number;
+}): Promise<{
+    changed: string;
+    category?: GradebookCategory;
+}>;
+export {};

package/dist/moodle/gradebook.js

@@ -0,0 +1,246 @@
+import { callService } from "./ajax.js";
+import { setFields } from "./forms.js";
+import { moodleErrorMessage, openSitePage } from "./session.js";
+/** The gradebook can't be read or changed: not allowed, recalculating, or a value Moodle refuses. */
+export class GradebookError extends Error {
+    name = "GradebookError";
+}
+/** Moodle's aggregations by their constant (GRADE_AGGREGATE_*). */
+const AGGREGATION_CODES = {
+    mean: 0,
+    median: 2,
+    lowest: 4,
+    highest: 6,
+    mode: 8,
+    "weighted-mean": 10,
+    "simple-weighted-mean": 11,
+    "mean-with-extra-credits": 12,
+    natural: 13,
+};
+export const GRADE_AGGREGATIONS = Object.keys(AGGREGATION_CODES);
+/** One page of the grader report, by data attributes and links, in any language. */
+export function readGraderReport(page) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const columns = Array.from(doc.querySelectorAll("table#user-grades tr.heading th[data-itemid]")).map((th) => {
+            const header = th.querySelector(".gradeitemheader");
+            const copy = header?.cloneNode(true);
+            for (const extra of Array.from(copy?.querySelectorAll("img, .visually-hidden") ?? []))
+                extra.remove();
+            const match = /\/mod\/([a-z0-9_]+)\/view\.php\?(?:.*&)?id=(\d+)/.exec(header?.getAttribute("href") ?? "");
+            const kind = /\bcourseitem\b/.test(th.className) ? "course" : /\bcategoryitem\b/.test(th.className) ? "category" : "item";
+            return {
+                itemId: Number(th.getAttribute("data-itemid")),
+                name: (copy?.textContent ?? "").replace(/\s+/g, " ").trim(),
+                kind,
+                ...(match ? { activityId: Number(match[2]), activityType: match[1] } : {}),
+            };
+        });
+        const rows = Array.from(doc.querySelectorAll("table#user-grades tr.userrow[data-uid]")).map((row) => {
+            const link = row.querySelector("a.username")?.cloneNode(true);
+            for (const extra of Array.from(link?.querySelectorAll(".userinitials, img, .visually-hidden") ?? []))
+                extra.remove();
+            const grades = Array.from(row.querySelectorAll("td.gradecell[data-itemid]")).map((cell) => {
+                const value = (cell.querySelector(".gradevalue")?.textContent ?? "").replace(/\s+/g, " ").trim();
+                return { itemId: Number(cell.getAttribute("data-itemid")), ...(value && value !== "-" ? { grade: value } : {}) };
+            });
+            return { userId: Number(row.getAttribute("data-uid")), fullName: (link?.textContent ?? "").replace(/\s+/g, " ").trim(), grades };
+        });
+        return { columns, rows };
+    });
+}
+const MAX_PAGES = 100;
+/**
+ * Everyone's grades in a course as the grader report shows them, page by page, in one group when
+ * given. People come as user id and full name only.
+ */
+export async function graderReport(context, siteUrl, courseId, { group } = {}) {
+    const report = { columns: [], rows: [] };
+    const seen = new Set();
+    for (let p = 0; p < MAX_PAGES; p++) {
+        const page = await openSitePage(context, siteUrl, `grade/report/grader/index.php?id=${courseId}&page=${p}${group ? `&group=${group}` : ""}`);
+        try {
+            const refused = await moodleErrorMessage(page);
+            if (refused !== undefined || (await page.locator("body#page-grade-report-grader-index").count()) === 0) {
+                throw new GradebookError(`You can't see course ${courseId}'s grader report: ${refused ?? "the course doesn't exist, or you aren't allowed"}`);
+            }
+            // Moodle shows a progress bar instead while it recalculates grades (deleted activities, changed weights).
+            if ((await page.locator("table#user-grades").count()) === 0) {
+                throw new GradebookError(`Course ${courseId}'s grader report isn't available now: Moodle may be recalculating its grades. Try again in a moment.`);
+            }
+            const read = await readGraderReport(page);
+            if (p === 0)
+                report.columns = read.columns;
+            const fresh = read.rows.filter((row) => !seen.has(row.userId));
+            if (fresh.length === 0)
+                break;
+            for (const row of fresh)
+                seen.add(row.userId);
+            report.rows.push(...fresh);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    return report;
+}
+/** The gradebook setup page's rows, by data attributes and field names. */
+export function readGradebookSetup(page) {
+    return page.evaluate((codes) => {
+        const doc = globalThis.document;
+        const names = Object.fromEntries(Object.entries(codes).map(([name, code]) => [String(code), name]));
+        const categories = [];
+        const items = [];
+        for (const row of Array.from(doc.querySelectorAll("#grade_edit_tree_table tr[data-itemid]"))) {
+            const itemId = Number(row.getAttribute("data-itemid"));
+            const name = (row.querySelector(".rowtitle")?.textContent ?? "").replace(/\s+/g, " ").trim();
+            const parent = Number((row.getAttribute("data-parent-category") ?? "").replace(/^cg/, "")) || undefined;
+            const max = Number(row.getAttribute("data-grademax"));
+            const weightField = row.querySelector(`input[type="text"][name="weight_${itemId}"]`);
+            const weight = weightField && weightField.value !== "" ? Number(weightField.value) : undefined;
+            const category = row.getAttribute("data-category");
+            if (category) {
+                const aggregation = names[row.getAttribute("data-aggregation") ?? ""];
+                categories.push({
+                    id: Number(category.replace(/^cg/, "")),
+                    itemId,
+                    name,
+                    ...(parent ? { parentId: parent } : {}),
+                    ...(aggregation ? { aggregation: aggregation } : {}),
+                    ...(max > 0 ? { maxGrade: max } : {}),
+                    ...(weight !== undefined ? { weight } : {}),
+                });
+            }
+            else {
+                // The item's icon comes from its module's theme folder, or core's for a manual item.
+                const icon = /image\.php\/[^/]+\/([a-z0-9_]+)\//.exec(row.querySelector("img.itemicon")?.getAttribute("src") ?? "")?.[1];
+                items.push({
+                    id: itemId,
+                    name,
+                    ...(parent ? { categoryId: parent } : {}),
+                    type: !icon || icon === "core" ? "manual" : icon,
+                    ...(max > 0 ? { maxGrade: max } : {}),
+                    ...(weight !== undefined ? { weight } : {}),
+                    weightOverridden: row.querySelector(`input[type="checkbox"][name="weightoverride_${itemId}"]`)?.checked ?? false,
+                });
+            }
+        }
+        return { categories, items };
+    }, AGGREGATION_CODES);
+}
+/** A course's gradebook setup: its categories (aggregation, weights) and grade items (category, maximum, weight). */
+export async function gradebookSetup(context, siteUrl, courseId) {
+    const page = await openSitePage(context, siteUrl, `grade/edit/tree/index.php?id=${courseId}`);
+    try {
+        if ((await page.locator("body#page-grade-edit-tree-index #grade_edit_tree_table").count()) === 0) {
+            throw new GradebookError(`You can't see course ${courseId}'s gradebook setup: ${(await moodleErrorMessage(page)) ?? "the course doesn't exist, or you aren't allowed to manage its grades"}`);
+        }
+        const setup = await readGradebookSetup(page);
+        // Category and course totals are their categories' own items, not items of their own.
+        const totals = new Set(setup.categories.map((c) => c.itemId));
+        return { categories: setup.categories, items: setup.items.filter((item) => !totals.has(item.id)) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Fills one of Moodle's dynamic forms (core_form_dynamic_form) as its modal does: rendered by the
+ * service, filled in a blank tab, serialized and sent back. Throws `GradebookError` with Moodle's
+ * messages when it comes back unsubmitted; `prepare` can check the form before it's filled.
+ */
+async function submitDynamicForm(context, siteUrl, form, params, values, prepare) {
+    const formdata = new URLSearchParams(Object.entries(params).map(([key, value]) => [key, String(value)])).toString();
+    const rendered = await callService(context, siteUrl, "core_form_dynamic_form", { form, formdata });
+    const page = await context.newPage();
+    try {
+        await page.setContent(rendered.html);
+        await prepare?.(page);
+        await setFields(page, values);
+        const serialized = await page.evaluate(() => {
+            const g = globalThis;
+            return new g.URLSearchParams(new g.FormData(g.document.querySelector("form.mform"))).toString();
+        });
+        const answer = await callService(context, siteUrl, "core_form_dynamic_form", { form, formdata: serialized });
+        if (answer.submitted)
+            return;
+        // Back unsubmitted: the form again, with its errors (ids carry a random suffix).
+        await page.setContent(answer.html);
+        const errors = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll('[id^="id_error_"]'))
+            .map((element) => ({ field: element.id.slice("id_error_".length).replace(/_[A-Za-z0-9]{15}$/, ""), message: (element.textContent ?? "").replace(/\s+/g, " ").trim() }))
+            .filter((error) => error.message !== ""));
+        throw new GradebookError(`Moodle refused the form: ${errors.map((e) => `${e.field}: ${e.message}`).join("; ") || "no reason given"}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Moves a grade item (`ig<id>`) or category (`cg<id>`) to the start of a category, as the setup page's "Move" does. */
+async function moveIntoCategory(context, siteUrl, courseId, element, categoryId) {
+    const page = await openSitePage(context, siteUrl, `grade/edit/tree/index.php?id=${courseId}`);
+    try {
+        const sesskey = await page.evaluate(() => globalThis.M.cfg.sesskey);
+        const move = `grade/edit/tree/index.php?id=${courseId}&action=move&eid=${element}&moveafter=cg${categoryId}&first=1&sesskey=${sesskey}`;
+        await page.goto(new URL(move, siteUrl).href, { waitUntil: "domcontentloaded" });
+        if ((await page.locator("#grade_edit_tree_table").count()) === 0) {
+            throw new GradebookError(`Moodle didn't move ${element.startsWith("cg") ? "category" : "item"} ${element.slice(2)} into category ${categoryId}: check both ids in the gradebook setup.`);
+        }
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Changes a grade item: moves it into a category, sets its weight (percent, overriding Natural's
+ * automatic one), or its maximum grade (a manual item's; an activity's is set in the activity).
+ * Returns the item afterwards.
+ */
+export async function updateGradeItem(context, siteUrl, courseId, itemId, { category, weight, maxGrade }) {
+    if (category !== undefined)
+        await moveIntoCategory(context, siteUrl, courseId, `ig${itemId}`, category);
+    if (weight !== undefined || maxGrade !== undefined) {
+        const values = {};
+        if (weight !== undefined)
+            Object.assign(values, { weightoverride: 1, aggregationcoef2: weight });
+        if (maxGrade !== undefined)
+            values.grademax = maxGrade;
+        await submitDynamicForm(context, siteUrl, "core_grades\\form\\add_item", { courseid: courseId, itemid: itemId }, values, async (page) => {
+            const fields = await page.evaluate(() => {
+                const doc = globalThis.document;
+                const max = doc.querySelector('[name="grademax"]');
+                return { maxEditable: max !== null && !max.disabled, weight: doc.querySelector('[name="aggregationcoef2"]') !== null };
+            });
+            if (maxGrade !== undefined && !fields.maxEditable) {
+                throw new GradebookError(`Item ${itemId} belongs to an activity: its maximum grade is set in the activity's settings, not in the gradebook.`);
+            }
+            if (weight !== undefined && !fields.weight)
+                throw new GradebookError(`Item ${itemId}'s category doesn't aggregate with weights that can be set (Natural): change its aggregation first.`);
+        });
+    }
+    const done = [category !== undefined && `moved into category ${category}`, weight !== undefined && `weighted ${weight}%`, maxGrade !== undefined && `out of ${maxGrade}`].filter(Boolean);
+    const item = (await gradebookSetup(context, siteUrl, courseId)).items.find((i) => i.id === itemId);
+    return { changed: done.length > 0 ? `Grade item ${itemId} ${done.join(", ")}.` : "Nothing to change.", item };
+}
+/** Adds a grade category (at the course's top level, or inside `parentId`); returns it as the setup shows it. */
+export async function addGradeCategory(context, siteUrl, courseId, { name, aggregation, parentId }) {
+    const before = new Set((await gradebookSetup(context, siteUrl, courseId)).categories.map((c) => c.id));
+    const values = { fullname: name };
+    if (aggregation !== undefined)
+        values.aggregation = AGGREGATION_CODES[aggregation];
+    await submitDynamicForm(context, siteUrl, "core_grades\\form\\add_category", { courseid: courseId }, values, async (page) => {
+        if (aggregation === undefined)
+            return;
+        const offered = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll('[name="aggregation"] option')).map((o) => o.value));
+        if (!offered.includes(String(AGGREGATION_CODES[aggregation]))) {
+            const available = GRADE_AGGREGATIONS.filter((a) => offered.includes(String(AGGREGATION_CODES[a])));
+            throw new GradebookError(`The site doesn't offer the ${aggregation} aggregation; it offers: ${available.join(", ")}.`);
+        }
+    });
+    let created = (await gradebookSetup(context, siteUrl, courseId)).categories.find((c) => !before.has(c.id));
+    if (created && parentId !== undefined) {
+        await moveIntoCategory(context, siteUrl, courseId, `cg${created.id}`, parentId);
+        created = (await gradebookSetup(context, siteUrl, courseId)).categories.find((c) => c.id === created.id);
+    }
+    return { changed: `Grade category ${created?.id ?? "?"} "${name}" added${parentId !== undefined ? ` in category ${parentId}` : ""}.`, category: created };
+}
+//# sourceMappingURL=gradebook.js.map

package/dist/moodle/gradebook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradebook.js","sourceRoot":"","sources":["../../src/moodle/gradebook.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,qGAAqG;AACrG,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,GAAG,gBAAgB,CAAC;CAClC;AAED,mEAAmE;AACnE,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,eAAe,EAAE,EAAE;IACnB,sBAAsB,EAAE,EAAE;IAC1B,yBAAyB,EAAE,EAAE;IAC7B,OAAO,EAAE,EAAE;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAuB,CAAC;AAgBvF,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QASxB,MAAM,GAAG,GAAI,UAA0C,CAAC,QAAQ,CAAC;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,8CAA8C,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAC1G,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;gBAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YACtG,MAAM,KAAK,GAAG,kDAAkD,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1G,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1H,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC9C,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;gBAC3D,IAAI;gBACJ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,wCAAwC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAClG,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,sCAAsC,CAAC,IAAI,EAAE,CAAC;gBAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YACrH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACxF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBACjG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACnH,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;QACnI,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAkB,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB,EAAE,OAAe,EAAE,QAAgB,EAAE,EAAE,KAAK,KAAyB,EAAE;IAC/H,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,oCAAoC,QAAQ,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7I,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvG,MAAM,IAAI,cAAc,CAAC,wBAAwB,QAAQ,qBAAqB,OAAO,IAAI,iDAAiD,EAAE,CAAC,CAAC;YAChJ,CAAC;YACD,0GAA0G;YAC1G,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,cAAc,CAAC,UAAU,QAAQ,sGAAsG,CAAC,CAAC;YACrJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC9B,KAAK,MAAM,GAAG,IAAI,KAAK;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AA0BD,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;QAU7B,MAAM,GAAG,GAAI,UAA0C,CAAC,QAAQ,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACpG,MAAM,UAAU,GAAwB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,wCAAwC,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC;YACxG,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,mCAAmC,MAAM,IAAI,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,WAAW,IAAI,WAAW,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/F,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YACnD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtE,UAAU,CAAC,IAAI,CAAC;oBACd,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACvC,MAAM;oBACN,IAAI;oBACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAA+B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5C,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,qFAAqF;gBACrF,MAAM,IAAI,GAAG,mCAAmC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACzH,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,MAAM;oBACV,IAAI;oBACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;oBAChD,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,gBAAgB,EAAE,GAAG,CAAC,aAAa,CAAC,+CAA+C,MAAM,IAAI,CAAC,EAAE,OAAO,IAAI,KAAK;iBACjH,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACxB,CAAC;AAED,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAuB,EAAE,OAAe,EAAE,QAAgB;IAC7F,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjG,MAAM,IAAI,cAAc,CAAC,wBAAwB,QAAQ,uBAAuB,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,sEAAsE,EAAE,CAAC,CAAC;QAChM,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7C,sFAAsF;QACtF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACrG,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,iBAAiB,CAC9B,OAAuB,EACvB,OAAe,EACf,IAAY,EACZ,MAAuC,EACvC,MAAkC,EAClC,OAAuC;IAEvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAoB,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtI,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAmB,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC1C,MAAM,CAAC,GAAG,UAIT,CAAC;YACF,OAAO,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClG,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAuC,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QACnJ,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO;QAC7B,iFAAiF;QACjF,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CACtC,KAAK,CAAC,IAAI,CAAE,UAA8H,CAAC,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;aACvL,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;aACtK,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,EAAE,CAAC,CAC3C,CAAC;QACF,MAAM,IAAI,cAAc,CAAC,4BAA4B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,GAAG,CAAC,CAAC;IACzI,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,wHAAwH;AACxH,KAAK,UAAU,gBAAgB,CAAC,OAAuB,EAAE,OAAe,EAAE,QAAgB,EAAE,OAAe,EAAE,UAAkB;IAC7H,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAE,UAA6D,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxH,MAAM,IAAI,GAAG,gCAAgC,QAAQ,oBAAoB,OAAO,gBAAgB,UAAU,oBAAoB,OAAO,EAAE,CAAC;QACxI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,cAAc,CAAC,sBAAsB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,UAAU,0CAA0C,CAAC,CAAC;QAC3L,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAA6D;IAEzF,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IACxG,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACvD,MAAM,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,6BAA6B,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtI,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;gBACtC,MAAM,GAAG,GAAI,UAAkG,CAAC,QAAQ,CAAC;gBACzH,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;gBACnD,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,2BAA2B,CAAC,KAAK,IAAI,EAAE,CAAC;YACzH,CAAC,CAAC,CAAC;YACH,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,IAAI,cAAc,CAAC,QAAQ,MAAM,qGAAqG,CAAC,CAAC;YAChJ,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,MAAM,qGAAqG,CAAC,CAAC;QAC5L,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,uBAAuB,QAAQ,EAAE,EAAE,MAAM,KAAK,SAAS,IAAI,YAAY,MAAM,GAAG,EAAE,QAAQ,KAAK,SAAS,IAAI,UAAU,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1L,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACnG,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;AAChH,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,OAAe,EACf,QAAgB,EAChB,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAuE;IAEpG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvG,MAAM,MAAM,GAA+B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACnF,MAAM,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,iCAAiC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC1H,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CACvC,KAAK,CAAC,IAAI,CAAE,UAAqG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAChM,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnG,MAAM,IAAI,cAAc,CAAC,8BAA8B,WAAW,4BAA4B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,GAAG,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3G,IAAI,OAAO,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QAChF,OAAO,GAAG,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAQ,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,kBAAkB,OAAO,EAAE,EAAE,IAAI,GAAG,KAAK,IAAI,UAAU,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC5J,CAAC"}

package/dist/moodle/grades.d.ts

@@ -0,0 +1,24 @@
+import type { BrowserContext, Page } from "playwright-core";
+/** A row of the user grade report, values as Moodle shows them ("-" left out). */
+export interface GradeRow {
+    /** A category's total row is "categoryTotal"; the course's, "courseTotal". */
+    kind: "item" | "category" | "categoryTotal" | "courseTotal";
+    name: string;
+    activityId?: number;
+    activityType?: string;
+    grade?: string;
+    range?: string;
+    percentage?: string;
+    weight?: string;
+    letter?: string;
+    feedback?: string;
+    contribution?: string;
+}
+/** The person can't see the grade report of that course. */
+export declare class NoGradeReportError extends Error {
+    name: string;
+}
+/** The rows of `table.user-grade`, by cell classes, never by header texts (ADR-004). */
+export declare function readGradeRows(page: Page): Promise<GradeRow[]>;
+/** The person's own grade report for a course. */
+export declare function myGrades(context: BrowserContext, siteUrl: string, courseId: number): Promise<GradeRow[]>;

package/dist/moodle/grades.js

@@ -0,0 +1,67 @@
+import { openSitePage } from "./session.js";
+/** The person can't see the grade report of that course. */
+export class NoGradeReportError extends Error {
+    name = "NoGradeReportError";
+}
+/** The rows of `table.user-grade`, by cell classes, never by header texts (ADR-004). */
+export function readGradeRows(page) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const rows = Array.from(doc.querySelectorAll("table.user-grade tr"));
+        const result = [];
+        for (const row of rows) {
+            const nameCell = row.querySelector(".column-itemname");
+            if (!nameCell || row.querySelector("th.column-itemname[scope='col'], thead"))
+                continue;
+            const classes = nameCell.className;
+            // Both totals are "baggt" rows; a category's holds a categoryitem block (confirmed empirically, Moodle 5.2).
+            const total = nameCell.querySelector(".categoryitem") ? "categoryTotal" : "courseTotal";
+            const kind = /\bbaggt\b/.test(classes) ? total : /\bcategory\b/.test(classes) ? "category" : /\bitem\b/.test(classes) ? "item" : undefined;
+            if (!kind)
+                continue;
+            const values = {};
+            for (const column of ["grade", "range", "percentage", "weight", "lettergrade", "feedback", "contributiontocoursetotal"]) {
+                const cell = row.querySelector(`.column-${column}`);
+                if (!cell)
+                    continue;
+                // The grade cell also holds an action menu whose text is in the site's language.
+                const copy = cell.cloneNode(true);
+                for (const menu of Array.from(copy.querySelectorAll(".action-menu, .dropdown, .visually-hidden")))
+                    menu.remove();
+                const text = (copy.textContent ?? "").replace(/\s+/g, " ").trim();
+                values[column] = text === "" || text === "-" ? undefined : text;
+            }
+            const link = nameCell.querySelector('a[href*="/mod/"][href*="view.php"]');
+            const href = link?.getAttribute("href") ?? "";
+            const match = /\/mod\/([a-z0-9_]+)\/view\.php\?(?:.*&)?id=(\d+)/.exec(href);
+            result.push({
+                kind,
+                name: ((nameCell.querySelector(".rowtitle") ?? nameCell).textContent ?? "").replace(/\s+/g, " ").trim(),
+                activityId: match ? Number(match[2]) : undefined,
+                activityType: match ? match[1] : undefined,
+                grade: values.grade,
+                range: values.range,
+                percentage: values.percentage,
+                weight: values.weight,
+                letter: values.lettergrade,
+                feedback: values.feedback,
+                contribution: values.contributiontocoursetotal,
+            });
+        }
+        return result;
+    });
+}
+/** The person's own grade report for a course. */
+export async function myGrades(context, siteUrl, courseId) {
+    const page = await openSitePage(context, siteUrl, `grade/report/user/index.php?id=${courseId}`);
+    try {
+        if ((await page.locator("body#page-grade-report-user-index table.user-grade").count()) === 0) {
+            throw new NoGradeReportError(`There's no grade report of yours to read in course ${courseId}: the course doesn't exist, you aren't graded there, or grades are hidden.`);
+        }
+        return await readGradeRows(page);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=grades.js.map

package/dist/moodle/grades.js.map

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

package/dist/moodle/grading.d.ts

@@ -0,0 +1,92 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { type PluginContent } from "./assign.js";
+import { type FieldValue } from "./forms.js";
+export interface Submission {
+    userId: number;
+    fullName: string;
+    /** Moodle's status: "submitted", "draft", "new", "reopened", or "none" without a submission. */
+    status: string;
+    submitted: boolean;
+    needsGrading: boolean;
+    extensionGranted: boolean;
+    /** Until when, where an extension is granted. */
+    extensionDueDate?: string;
+    allowSubmissionsFrom?: string;
+    /** For this participant: overrides and extensions included. */
+    dueDate?: string;
+    cutoffDate?: string;
+    /** Per submission plugin; only for submitted and draft submissions. */
+    content?: PluginContent[];
+}
+/** Every participant's submission to an assignment, with its content unless `includeContent` is false. */
+export declare function assignmentSubmissions(context: BrowserContext, siteUrl: string, cmid: number, { includeContent }?: {
+    includeContent?: boolean | undefined;
+}): Promise<{
+    assignment: {
+        id: number;
+        instanceId: number;
+    };
+    submissions: Submission[];
+}>;
+/**
+ * Grades a participant as the grader does: a grade (simple grading), a rubric's level per criterion
+ * or a marking guide's score per criterion (by their ids, from `rubric()`), remarks per criterion,
+ * feedback comments (HTML), whether to notify, and any other grading field by name. Returns the
+ * grade saved and the gradebook's grade, the total Moodle computes for a rubric or a guide.
+ */
+export declare function gradeSubmission(context: BrowserContext, siteUrl: string, cmid: number, userId: number, { grade, rubric, guide, remarks, feedback, notify, fields, }: {
+    grade?: string;
+    /** Criterion id → level id. */
+    rubric?: Record<number, number>;
+    /** Criterion id → score. */
+    guide?: Record<number, number>;
+    /** Criterion id → remark, for a rubric or a guide. */
+    remarks?: Record<number, string>;
+    feedback?: string;
+    notify?: boolean;
+    fields?: Record<string, FieldValue>;
+}): Promise<{
+    grade?: string;
+    gradebookGrade?: string;
+    feedback?: string;
+    changed: string;
+}>;
+export interface GradingCriterion {
+    id: number;
+    /** A rubric criterion's description; a guide criterion's short name. */
+    description: string;
+    /** A guide criterion's description for students and for markers. */
+    details?: string;
+    markers?: string;
+    /** A rubric criterion's levels, by the ids grading takes. */
+    levels?: {
+        id: number;
+        definition: string;
+        score: number;
+    }[];
+    /** A guide criterion's maximum score. */
+    maxScore?: number;
+}
+export interface GradingDefinition {
+    /** "simple" for a plain grade (or a scale), "rubric" or "guide" for advanced grading. */
+    method: "simple" | "rubric" | "guide";
+    criteria: GradingCriterion[];
+}
+/** The grading method and its criteria, read from a grading panel's form by field names and blocks. */
+export declare function readGradingDefinition(page: Page, panelHtml: string): Promise<GradingDefinition>;
+/**
+ * An assignment's grading method and, for a rubric or a marking guide, its criteria with the ids
+ * `gradeSubmission` takes: read from the grader's panel for its first participant.
+ */
+export declare function rubric(context: BrowserContext, siteUrl: string, cmid: number): Promise<{
+    assignment: {
+        id: number;
+    };
+} & GradingDefinition>;
+/**
+ * Grants participants an extension until a date, through the assignment's extension form (several at
+ * once as its bulk action does). Moodle refuses a date before the assignment's due date.
+ */
+export declare function grantExtension(context: BrowserContext, siteUrl: string, cmid: number, userIds: number[], until: Date): Promise<{
+    changed: string;
+}>;