@falkenslab/moodle-driver 0.0.0-stage → 0.4.0

package/dist/categories.js

@@ -0,0 +1,225 @@
+// What data each public function reads or writes, so a program can decide what to allow (an agent
+// that builds content but never reads students' work) without classifying the driver by hand.
+/**
+ * A kind of data a function reads or writes:
+ * - `none`: the session or the site, nothing of anyone's; also functions that only parse what the
+ *   caller already fetched (a page, HTML, JSON), whose data belongs to whatever fetched it.
+ * - `own`: the person's own data and actions (their courses, attempts, submissions, grades).
+ * - `course-content`: what teachers make (structure, activities' content and settings, rubrics' definitions, questions).
+ * - `others-aggregate`: counts about others that identify no one ("2 of 4 submitted").
+ * - `others-personal`: others' data or work (names, roles, submissions, posts, attempts, responses, grades).
+ * - `others-write`: deciding about others (grades, feedback, extensions, overrides, completion).
+ * - `communication`: writing to or before others (forum posts, messages).
+ * - `any`: generic primitives that reach whatever they're pointed at (services, pages, forms).
+ */
+export const ALL_DATA_CATEGORIES = ["none", "own", "course-content", "others-aggregate", "others-personal", "others-write", "communication", "any"];
+const NONE = ["none"];
+const OWN = ["own"];
+const CONTENT = ["course-content"];
+const PERSONAL = ["others-personal"];
+const ANY = ["any"];
+/**
+ * The data categories of every function exported from the package, and of the browser manager's
+ * methods (`BrowserManager.<method>`) and the Moodle object's own (`Moodle.<method>`; its other methods are
+ * the functions of the same name). A function that may touch several kinds lists them all; a
+ * program takes the strictest. Functions that read activities of any module answer per module
+ * through `moduleCategories()`.
+ */
+export const DATA_CATEGORIES = {
+    // The browser and the session.
+    createBrowserManager: NONE,
+    // The Moodle object: its bound methods are classified as their functions, of the same name.
+    createMoodle: NONE,
+    "Moodle.context": NONE,
+    "Moodle.logIn": NONE,
+    "Moodle.publicSiteInfo": NONE,
+    "Moodle.callService": ANY,
+    "Moodle.openScorm": OWN,
+    "Moodle.tab": ANY,
+    "Moodle.visible": NONE,
+    "Moodle.setVisible": NONE,
+    "Moodle.saveSession": NONE,
+    "Moodle.close": NONE,
+    // The context is what every function takes: what's done with it is classified by those functions.
+    "BrowserManager.context": NONE,
+    "BrowserManager.openChannel": NONE,
+    "BrowserManager.chromiumDownload": NONE,
+    "BrowserManager.visible": NONE,
+    "BrowserManager.setVisible": NONE,
+    "BrowserManager.show": NONE,
+    "BrowserManager.tab": ANY,
+    "BrowserManager.saveSession": NONE,
+    "BrowserManager.close": NONE,
+    canShowWindow: NONE,
+    parseSiteUrl: NONE,
+    siteProfileDir: NONE,
+    findMoodleSite: NONE,
+    readWwwroot: NONE,
+    publicSiteInfo: NONE,
+    siteName: NONE,
+    logIn: NONE,
+    logOut: NONE,
+    readSessionFacts: NONE,
+    htmlSessionFacts: NONE,
+    readMoodleConfig: NONE,
+    isLoggedIn: NONE,
+    pageIsLoggedIn: NONE,
+    dateSelectorValues: NONE,
+    dateSelectorDate: NONE,
+    moodleErrorMessage: NONE,
+    moduleCategories: NONE,
+    // Generic primitives.
+    callService: ANY,
+    openSitePage: ANY,
+    fetchSitePage: ANY,
+    inPage: ANY,
+    openForm: ANY,
+    formValue: ANY,
+    setFields: ANY,
+    uploadToDraft: ANY,
+    submitForm: ANY,
+    editCourse: ANY,
+    // Parsing and pacing helpers: nothing fetched.
+    decodeEntities: NONE,
+    readTexts: NONE,
+    readMedia: NONE,
+    readingSeconds: NONE,
+    pause: NONE,
+    checkLocalFiles: NONE,
+    fileNameFor: NONE,
+    // The person.
+    readOwnProfile: OWN,
+    readPageConfig: OWN,
+    whoAmI: OWN,
+    courseAbilities: OWN,
+    listCourses: OWN,
+    updateCourse: CONTENT,
+    myGrades: OWN,
+    deadlines: OWN,
+    pendingActivities: OWN,
+    userById: PERSONAL,
+    courseRoles: PERSONAL,
+    // Courses and their content. The course's state carries the person's own completion.
+    courseState: ["course-content", "own"],
+    courseStructure: ["course-content", "own"],
+    activityDetails: CONTENT,
+    courseActivityTypes: CONTENT,
+    listAssignments: CONTENT,
+    activityContent: CONTENT,
+    createActivity: CONTENT,
+    activitySettings: CONTENT,
+    updateActivity: CONTENT,
+    editActivity: CONTENT,
+    duplicateActivity: CONTENT,
+    deleteActivity: CONTENT,
+    addSection: CONTENT,
+    editSection: CONTENT,
+    deleteSection: CONTENT,
+    renameActivity: CONTENT,
+    renameSection: CONTENT,
+    activitiesOverview: ["course-content", "own", "others-aggregate"],
+    courseUpdates: ["course-content", "others-aggregate"],
+    // Course files, or others' (a submission's, a post's attachment): a program checks the URL.
+    downloadFile: ["course-content", "others-personal"],
+    // Assignments.
+    studentAssignment: ["course-content", "own"],
+    saveSubmission: OWN,
+    submitForGrading: OWN,
+    assignmentSubmissions: PERSONAL,
+    gradeSubmission: ["others-personal", "others-write"],
+    rubric: CONTENT,
+    grantExtension: ["others-write"],
+    // Quizzes: a teacher may review someone else's attempt.
+    quizInfo: ["course-content", "own"],
+    startQuizAttempt: OWN,
+    readAttempt: OWN,
+    answerQuizQuestions: OWN,
+    finishQuizAttempt: OWN,
+    readReview: ["own", "others-personal"],
+    setQuizOverride: ["others-write"],
+    quizResults: PERSONAL,
+    quizStructure: CONTENT,
+    addQuestionsToQuiz: CONTENT,
+    // Forums.
+    forumDiscussions: PERSONAL,
+    discussion: PERSONAL,
+    replyToPost: ["communication"],
+    startDiscussion: ["communication"],
+    setDiscussionState: ["others-personal", "communication"],
+    // Surveys.
+    getSurvey: ["course-content", "own"],
+    submitSurvey: OWN,
+    // Participants and groups.
+    participants: PERSONAL,
+    groups: PERSONAL,
+    participantFilters: ["course-content"],
+    // Completion: the person's own, deciding someone else's, everyone's report.
+    setCompletion: OWN,
+    overrideCompletion: ["others-write"],
+    completionReport: PERSONAL,
+    // The gradebook: everyone's grades, and its setup (course content).
+    graderReport: PERSONAL,
+    gradebookSetup: CONTENT,
+    updateGradeItem: CONTENT,
+    addGradeCategory: CONTENT,
+    // Question banks: what teachers write.
+    questionBanks: CONTENT,
+    questions: CONTENT,
+    importQuestions: CONTENT,
+    createQuestion: CONTENT,
+    // Messaging: the person's own notifications; conversations hold others' messages; sending is communication.
+    notifications: OWN,
+    markNotificationsRead: OWN,
+    conversations: PERSONAL,
+    conversation: PERSONAL,
+    sendMessage: ["communication"],
+    // The calendar: the person's upcoming events; course events are what teachers set.
+    upcomingEvents: ["own", "course-content"],
+    createEvent: CONTENT,
+    deleteEvent: CONTENT,
+    // H5P: the content (course content) and the person's own attempts.
+    h5pActivity: ["course-content", "own"],
+    scorm: ["course-content", "own"],
+    openScorm: OWN,
+    // Lessons: the person going through one.
+    lessonPage: ["course-content", "own"],
+    answerLessonPage: OWN,
+    // Choices: the person's own answer.
+    getChoice: ["course-content", "own"],
+    answerChoice: OWN,
+};
+// Modules whose activities hold only what teachers made: nobody else's work or responses.
+const CONTENT_MODULES = new Set(["page", "book", "label", "url", "resource", "folder", "imscp", "subsection", "qbank"]);
+// Modules that also hold participants' work or responses (forum posts, glossary entries, attempts…).
+const PARTICIPANT_MODULES = new Set([
+    "assign",
+    "quiz",
+    "feedback",
+    "questionnaire",
+    "choice",
+    "lesson",
+    "h5pactivity",
+    "scorm",
+    "survey",
+    "lti",
+    "bigbluebuttonbn",
+    "forum",
+    "glossary",
+    "wiki",
+    "data",
+    "workshop",
+    "chat",
+]);
+/**
+ * The data a teacher reads when reading an activity of `module` with everything in it: course
+ * content alone for what teachers make (pages, books, files…), also others' personal data where
+ * participants leave work or responses. An unknown module (a plugin) could hold anything: `any`.
+ */
+export function moduleCategories(module) {
+    if (CONTENT_MODULES.has(module))
+        return CONTENT;
+    if (PARTICIPANT_MODULES.has(module))
+        return ["course-content", "others-personal"];
+    return ANY;
+}
+//# sourceMappingURL=categories.js.map

package/dist/categories.js.map

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

package/dist/chromiumInstaller.d.ts

@@ -0,0 +1,15 @@
+import { type ChildProcess } from "node:child_process";
+export type InstallChromium = () => Promise<void>;
+/**
+ * Starts a process that `killTree` can end with everything it starts: on Linux and macOS as the
+ * leader of its own process group; on Windows `taskkill /T` walks the tree, and no console opens.
+ */
+export declare function spawnTree(command: string, args: string[]): ChildProcess;
+/** Ends a process started by `spawnTree` and its children, at once; nothing if it's gone. */
+export declare function killTree(pid: number): void;
+/**
+ * Downloads the Chromium this `playwright-core` expects with its own CLI (ADR-001), into
+ * `PLAYWRIGHT_BROWSERS_PATH` when set, else the user's `ms-playwright` cache. The CLI is in
+ * `node_modules`, where `playwright-core` is (a peer dependency).
+ */
+export declare const installChromium: InstallChromium;

package/dist/chromiumInstaller.js

@@ -0,0 +1,52 @@
+import { spawn, spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+/**
+ * Starts a process that `killTree` can end with everything it starts: on Linux and macOS as the
+ * leader of its own process group; on Windows `taskkill /T` walks the tree, and no console opens.
+ */
+export function spawnTree(command, args) {
+    return spawn(command, args, { stdio: ["ignore", "pipe", "pipe"], detached: process.platform !== "win32", windowsHide: true });
+}
+/** Ends a process started by `spawnTree` and its children, at once; nothing if it's gone. */
+export function killTree(pid) {
+    try {
+        if (process.platform === "win32")
+            spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+        else
+            process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        // Already gone.
+    }
+}
+/**
+ * Downloads the Chromium this `playwright-core` expects with its own CLI (ADR-001), into
+ * `PLAYWRIGHT_BROWSERS_PATH` when set, else the user's `ms-playwright` cache. The CLI is in
+ * `node_modules`, where `playwright-core` is (a peer dependency).
+ */
+export const installChromium = () => new Promise((resolve, reject) => {
+    const cli = path.join(path.dirname(createRequire(import.meta.url).resolve("playwright-core/package.json")), "cli.js");
+    // --no-shell: the driver launches full Chromium headless too (channel "chromium").
+    // --no-remove: the cache is shared, and other installations' browsers aren't ours to remove.
+    const child = spawnTree(process.execPath, [cli, "install", "chromium", "--no-shell", "--no-remove", "--no-progress"]);
+    // The CLI downloads from a child of its own: when the program exits, the whole tree goes with it,
+    // instead of downloading on with nobody to use it (a partial download is started over next time).
+    const stop = () => killTree(child.pid);
+    process.on("exit", stop);
+    // A program's stdout may be a protocol (an MCP server's): whatever the installer prints goes to stderr.
+    child.stdout.pipe(process.stderr, { end: false });
+    child.stderr.pipe(process.stderr, { end: false });
+    child.on("error", (error) => {
+        process.off("exit", stop);
+        reject(error);
+    });
+    child.on("exit", (code) => {
+        process.off("exit", stop);
+        if (code === 0)
+            resolve();
+        else
+            reject(new Error(`Chromium's installer exited with code ${code}`));
+    });
+});
+//# sourceMappingURL=chromiumInstaller.js.map

package/dist/chromiumInstaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromiumInstaller.js","sourceRoot":"","sources":["../src/chromiumInstaller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IACvD,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAChI,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;;YAC9H,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB,GAAG,EAAE,CACnD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtH,mFAAmF;IACnF,6FAA6F;IAC7F,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;IACtH,kGAAkG;IAClG,kGAAkG;IAClG,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAI,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,wGAAwG;IACxG,KAAK,CAAC,MAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,MAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;;YACrB,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,33 @@
+import type { CommandSpec, ParamSpec } from "./spec.js";
+/** A command line that doesn't fit the command: printed with how to get help, exit status 2. */
+export declare class UsageError extends Error {
+    name: string;
+}
+/** The command's own flags, set apart from the arguments. */
+export interface GlobalFlags {
+    site?: string;
+    profile?: string;
+    /** A named profile on the site (another account). */
+    as?: string;
+    allow?: string;
+    json: boolean;
+    show: boolean;
+    help: boolean;
+    version: boolean;
+}
+export declare const camel: (name: string) => string;
+export declare const kebab: (name: string) => string;
+/** The command named on the line, before any flags are read (they depend on it). */
+export declare function commandName(argv: string[]): string | undefined;
+/** The command for a name as typed: camelCase, kebab-case or any case (`login` is `logIn`). */
+export declare function findCommand(commands: readonly CommandSpec[], typed: string): CommandSpec | undefined;
+/** Splits the line into the global flags, the positional arguments and the command's flags. */
+export declare function splitLine(argv: string[], command: CommandSpec | undefined): {
+    global: GlobalFlags;
+    positionals: string[];
+    flags: Map<string, string[]>;
+};
+/** One value typed on the line, as its parameter takes it. */
+export declare function convert(raw: string[], spec: ParamSpec, cwd: string): unknown;
+/** The arguments the method is called with, from the positional values and the flags. */
+export declare function methodArguments(command: CommandSpec, positionals: string[], flags: Map<string, string[]>, cwd: string): unknown[];

package/dist/cli/args.js

@@ -0,0 +1,194 @@
+// The command line, read: the command, its positional arguments and `--flags`, each turned into the
+// value its parameter takes, by the command table.
+import path from "node:path";
+/** A command line that doesn't fit the command: printed with how to get help, exit status 2. */
+export class UsageError extends Error {
+    name = "UsageError";
+}
+const GLOBAL_VALUES = new Set(["site", "profile", "as", "allow"]);
+const GLOBAL_SWITCHES = new Set(["json", "show", "help", "version"]);
+// Fields that name local files or folders: relative paths are taken from the current folder.
+const PATH_FIELDS = new Set(["files", "file", "destDir"]);
+export const camel = (name) => name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+export const kebab = (name) => name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+/** The command named on the line, before any flags are read (they depend on it). */
+export function commandName(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (token === "-h")
+            continue;
+        if (token.startsWith("--")) {
+            const name = camel(token.slice(2).split("=")[0]);
+            if (GLOBAL_VALUES.has(name) && !token.includes("="))
+                i++;
+            continue;
+        }
+        return token;
+    }
+    return undefined;
+}
+/** The command for a name as typed: camelCase, kebab-case or any case (`login` is `logIn`). */
+export function findCommand(commands, typed) {
+    const key = typed.replace(/-/g, "").toLowerCase();
+    return commands.find((c) => c.name.toLowerCase() === key);
+}
+/** Splits the line into the global flags, the positional arguments and the command's flags. */
+export function splitLine(argv, command) {
+    const switches = new Set([...GLOBAL_SWITCHES, ...(command?.options?.fields ?? []).filter((f) => f.value.kind === "boolean").map((f) => f.name)]);
+    const global = { json: false, show: false, help: false, version: false };
+    const positionals = [];
+    const flags = new Map();
+    let commandSeen = false;
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (token === "-h") {
+            global.help = true;
+            continue;
+        }
+        if (!token.startsWith("--") || token === "--") {
+            if (!commandSeen)
+                commandSeen = true;
+            else
+                positionals.push(token);
+            continue;
+        }
+        const [rawName, inline] = splitOnce(token.slice(2), "=");
+        let name = camel(rawName);
+        let value = inline;
+        if (name.startsWith("no") && /^no[A-Z]/.test(name) && switches.has(name[2].toLowerCase() + name.slice(3))) {
+            name = name[2].toLowerCase() + name.slice(3);
+            value = "false";
+        }
+        if (value === undefined) {
+            if (switches.has(name))
+                value = "true";
+            else {
+                const next = argv[i + 1];
+                if (next === undefined)
+                    throw new UsageError(`--${kebab(name)} needs a value.`);
+                value = next;
+                i++;
+            }
+        }
+        if (GLOBAL_VALUES.has(name))
+            global[name] = value;
+        else if (GLOBAL_SWITCHES.has(name))
+            global[name] = value !== "false";
+        else
+            flags.set(name, [...(flags.get(name) ?? []), value]);
+    }
+    return { global, positionals, flags };
+}
+function splitOnce(text, separator) {
+    const at = text.indexOf(separator);
+    return at < 0 ? [text, undefined] : [text.slice(0, at), text.slice(at + 1)];
+}
+/** One value typed on the line, as its parameter takes it. */
+export function convert(raw, spec, cwd) {
+    const label = spec.name;
+    const one = raw[raw.length - 1];
+    const local = (p) => (PATH_FIELDS.has(spec.name) ? path.resolve(cwd, p) : p);
+    switch (spec.value.kind) {
+        case "number": {
+            const n = Number(one);
+            if (one.trim() === "" || !Number.isFinite(n))
+                throw new UsageError(`${label} must be a number, not "${one}".`);
+            return n;
+        }
+        case "boolean":
+            if (["true", "1", "yes"].includes(one))
+                return true;
+            if (["false", "0", "no"].includes(one))
+                return false;
+            throw new UsageError(`${label} must be true or false, not "${one}".`);
+        case "date": {
+            const date = new Date(one);
+            if (Number.isNaN(date.getTime()))
+                throw new UsageError(`${label} must be a date (2026-11-30, or 2026-11-30T18:00:00Z), not "${one}".`);
+            return date;
+        }
+        case "enum":
+            if (!spec.value.values.includes(one))
+                throw new UsageError(`${label} must be one of ${spec.value.values.join(", ")}, not "${one}".`);
+            return one;
+        case "numbers":
+            return raw.flatMap((r) => r.split(",")).map((r) => convert([r], { ...spec, value: { kind: "number" } }, cwd));
+        case "strings":
+            return raw.flatMap((r) => r.split(",")).map((r) => local(r.trim()));
+        case "json":
+            try {
+                return JSON.parse(one);
+            }
+            catch {
+                throw new UsageError(`${label} must be JSON (for example '{"a":1}' or '[1,2]'), not ${one}.`);
+            }
+        default:
+            return local(one);
+    }
+}
+// A field of an open options object (a service's arguments): JSON when it reads as JSON, else text.
+function loose(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/** The arguments the method is called with, from the positional values and the flags. */
+export function methodArguments(command, positionals, flags, cwd) {
+    const args = [];
+    command.params.forEach((param, i) => {
+        const raw = positionals[i];
+        if (raw === undefined) {
+            if (!param.optional)
+                throw new UsageError(`${kebab(command.name)} needs <${param.name}>.`);
+            args.push(undefined);
+        }
+        else
+            args.push(convert([raw], param, cwd));
+    });
+    if (positionals.length > command.params.length) {
+        throw new UsageError(`${kebab(command.name)} takes ${command.params.length} argument${command.params.length === 1 ? "" : "s"}, not ${positionals.length}: ${positionals.slice(command.params.length).join(" ")}.`);
+    }
+    const options = command.options;
+    if (!options) {
+        if (flags.size > 0)
+            throw new UsageError(`${kebab(command.name)} takes no options: --${[...flags.keys()].map(kebab).join(", --")}.`);
+        return trimTrailingUndefined(args);
+    }
+    let object = {};
+    const whole = flags.get("json");
+    if (whole) {
+        const parsed = loose(whole[whole.length - 1]);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            throw new UsageError(`--json must be a JSON object with ${options.name}.`);
+        object = { ...parsed };
+    }
+    for (const [name, raw] of flags) {
+        if (name === "json")
+            continue;
+        const field = options.fields.find((f) => f.name === name);
+        if (field)
+            object[name] = convert(raw, field, cwd);
+        else if (options.open)
+            object[name] = loose(raw[raw.length - 1]);
+        else {
+            const known = options.fields.map((f) => `--${kebab(f.name)}`).join(", ");
+            throw new UsageError(`${kebab(command.name)} has no option --${kebab(name)}${known ? `; its options are ${known}` : ""}.`);
+        }
+    }
+    const missing = options.fields.filter((f) => !f.optional && !(f.name in object));
+    if (missing.length > 0 && (!options.optional || Object.keys(object).length > 0)) {
+        throw new UsageError(`${kebab(command.name)} needs ${missing.map((f) => `--${kebab(f.name)}`).join(", ")}.`);
+    }
+    if (Object.keys(object).length > 0 || !options.optional)
+        args.push(object);
+    return trimTrailingUndefined(args);
+}
+function trimTrailingUndefined(args) {
+    while (args.length > 0 && args[args.length - 1] === undefined)
+        args.pop();
+    return args;
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/commands.generated.d.ts

@@ -0,0 +1,4 @@
+import type { CommandSpec } from "./spec.js";
+export declare const COMMANDS: readonly CommandSpec[];
+/** Methods with no command: they give a browser tab, which means nothing once the command exits. */
+export declare const LEFT_OUT: readonly string[];