@nanonets/graft 0.24.0 → 0.24.1

package/dist/notes/lesson-index.js

@@ -0,0 +1,135 @@
+/**
+ * D117 (4): the lesson learnings in a folder, through an index keyed by each
+ * file's mtime, ctime, size and inode, so the wall fix (PostToolUseFailure,
+ * 30 ms p95) doesn't parse every every-repo learning on each hit. At 1,000
+ * files a warm read is one readdir and one lstat a file.
+ *
+ * The index (`~/.trail/state/lesson-index.json`) is only a cache of what the
+ * files say: an entry whose key isn't the file's now is read again from the
+ * file, a file that is gone is gone, a link is never followed. It is written
+ * at Stop and session start only (`write`), never on PostToolUseFailure (R34),
+ * which reads it and parses what changed in memory.
+ */
+import { lstatSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseNote } from './notes.js';
+import { everyRepoDir } from './every-repo.js';
+import { repoNotesDir } from './repo-notes-dir.js';
+import { readJsonSafe, trailPath, writePrivate } from '../util/private-fs.js';
+/** A learning file over this is never read (lessons.ts's cap). */
+export const LESSON_FILE_MAX = 4 * 1024;
+const MAX_DIRS = 64;
+const MAX_INDEX_BYTES = 4 * 1024 * 1024;
+export const lessonIndexPath = (env) => trailPath(env, 'state', 'lesson-index.json');
+function readIndex(env) {
+    try {
+        if (lstatSync(lessonIndexPath(env)).size > MAX_INDEX_BYTES)
+            return { v: 1, dirs: {} };
+    }
+    catch {
+        return { v: 1, dirs: {} };
+    }
+    const raw = readJsonSafe(lessonIndexPath(env));
+    if (!raw || raw.v !== 1 || !raw.dirs || typeof raw.dirs !== 'object' || Array.isArray(raw.dirs))
+        return { v: 1, dirs: {} };
+    return raw;
+}
+const keyOf = (st) => `${st.mtimeMs}:${st.ctimeMs}:${st.size}:${st.ino}`;
+function parsed(path) {
+    const note = parseNote(readFileSync(path, 'utf8'), path);
+    if (!note || note.kind !== 'lesson')
+        return null;
+    const { id, kind, status, replaces, applies, wall, src, date, body } = note;
+    return { id, kind, status, replaces, applies, wall, src, date, body };
+}
+const shaped = (n) => !!n && typeof n === 'object' && typeof n.id === 'string'
+    && n.kind === 'lesson' && typeof n.date === 'string' && typeof n.body === 'string';
+/** The lessons in `dir`, by file name order, with the index's entries for `dir` brought up to date. */
+function readDir(dir, idx) {
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => n.endsWith('.md')).sort();
+    }
+    catch {
+        const changed = dir in idx.dirs;
+        delete idx.dirs[dir];
+        return { lessons: [], changed };
+    }
+    const had = idx.dirs[dir]?.files;
+    const old = had && typeof had === 'object' && !Array.isArray(had) ? had : {};
+    const files = {};
+    let changed = !idx.dirs[dir];
+    const lessons = [];
+    for (const name of names) {
+        const path = join(dir, name);
+        let st;
+        try {
+            st = lstatSync(path);
+        }
+        catch {
+            continue;
+        }
+        if (!st.isFile() || st.size > LESSON_FILE_MAX)
+            continue;
+        const k = keyOf(st);
+        const prev = Object.prototype.hasOwnProperty.call(old, name) ? old[name] : undefined;
+        let entry;
+        if (prev && prev.k === k && (prev.n === null || shaped(prev.n)))
+            entry = prev;
+        else {
+            try {
+                entry = { k, n: parsed(path) };
+            }
+            catch {
+                continue;
+            }
+            changed = true;
+        }
+        files[name] = entry;
+        if (entry.n)
+            lessons.push({ ...entry.n, path });
+    }
+    if (Object.keys(old).some((n) => !(n in files)))
+        changed = true;
+    idx.dirs[dir] = { files };
+    return { lessons, changed };
+}
+function save(idx, keep, env) {
+    // The folders asked about last stay; the index never grows past MAX_DIRS.
+    const names = Object.keys(idx.dirs);
+    if (names.length > MAX_DIRS)
+        for (const d of names.filter((n) => !keep.includes(n)).slice(0, names.length - MAX_DIRS))
+            delete idx.dirs[d];
+    try {
+        writePrivate(lessonIndexPath(env), JSON.stringify(idx));
+    }
+    catch { /* the next Stop writes it */ }
+}
+/** The lesson learnings in each of `dirs`, in that order. `write`: keep what changed in the index (Stop, session start). */
+export function lessonNotesIn(dirs, env, opts = {}) {
+    const idx = readIndex(env);
+    let changed = false;
+    const out = dirs.map((d) => {
+        const r = readDir(d, idx);
+        changed ||= r.changed;
+        return r.lessons;
+    });
+    if (changed && opts.write)
+        save(idx, dirs, env);
+    return out;
+}
+/** Stop and session start: the every-repo folder and this repo's personal one, read and kept in the index. Never throws. */
+export function refreshLessonIndex(repoKey, env) {
+    try {
+        const dirs = [everyRepoDir(env)];
+        if (repoKey) {
+            try {
+                dirs.push(repoNotesDir(repoKey, env));
+            }
+            catch { /* not a key */ }
+        }
+        lessonNotesIn(dirs, env, { write: true });
+    }
+    catch { /* the next one */ }
+}
+//# sourceMappingURL=lesson-index.js.map

package/dist/notes/lesson-index.js.map

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

package/dist/notes/linked-learnings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The Trail checkout a link on the way from the Trail home down to `dir` leads into, or null. Only the folders from
+ * the Trail home down are looked at (the home, `learnings`, then below), and only the ones that are links.
+ */
+export declare function linkedIntoCheckout(dir: string, env?: NodeJS.ProcessEnv): string | null;
+/** Throws when writing a learning in `dir` would land in a Trail checkout through a link. */
+export declare function refuseLinkedIntoCheckout(dir: string, env?: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=linked-learnings.d.ts.map

package/dist/notes/linked-learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-learnings.d.ts","sourceRoot":"","sources":["../../src/notes/linked-learnings.ts"],"names":[],"mappings":"AAiFA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAYnG;AAED,6FAA6F;AAC7F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAMhG"}

package/dist/notes/linked-learnings.js

@@ -0,0 +1,113 @@
+/**
+ * A linked `<trail home>/learnings` (D114 (1)). People link dotfile folders,
+ * so a link there, or at a folder below it, stays allowed. But when the
+ * link's real target is inside a git work tree that has a `.trail/` folder
+ * (a Trail checkout), a learning written through it would sit in that repo,
+ * ready to be committed for the team. Every writer of person-level learnings
+ * refuses that one case, before it writes.
+ *
+ * b7 review: the Trail home itself is one of the folders looked at (a linked
+ * `~/.trail` carries `learnings` with it); a link whose target isn't there
+ * yet is judged by where it would land, so it is refused before the folder
+ * is made, not only after; and a home folder that is itself a work tree is
+ * no Trail checkout because of its own `.trail`, the Trail home.
+ *
+ * Node builtins only, no git call: a work tree is the nearest folder above
+ * the target holding `.git` (a folder, or a worktree's file).
+ */
+import { existsSync, lstatSync, readlinkSync, realpathSync } from 'node:fs';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { trailHome } from './trail-home.js';
+import { trailPath } from '../util/private-fs.js';
+/** The nearest work tree root at or above `start` (a real path, or where one would be), or null. */
+function workTreeOf(start) {
+    let at = start;
+    for (let i = 0; i < 256; i++) {
+        if (existsSync(join(at, '.git')))
+            return at;
+        const up = dirname(at);
+        if (up === at)
+            return null;
+        at = up;
+    }
+    return null;
+}
+const isDir = (p) => {
+    try {
+        return lstatSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+const isLink = (p) => {
+    try {
+        return lstatSync(p).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Where `p` really is: its real path, or for a path that isn't there yet (a link to a folder not made), the real
+ * path its links lead to so far with the rest of the name after it. Bounded, so a link loop ends.
+ */
+function landsAt(p, hops = 0) {
+    try {
+        return realpathSync(p);
+    }
+    catch { /* not there (yet) */ }
+    if (hops > 40)
+        return resolve(p);
+    if (isLink(p)) {
+        try {
+            return landsAt(resolve(dirname(p), readlinkSync(p)), hops + 1);
+        }
+        catch {
+            return resolve(p);
+        }
+    }
+    const up = dirname(p);
+    return up === p ? p : join(landsAt(up, hops + 1), basename(p));
+}
+/** The Trail home's own `.trail`, reached with no link: a home folder that is a work tree is not a checkout for it. */
+function isTrailHomeItself(tree, env) {
+    const home = trailHome(env);
+    if (isLink(home))
+        return false;
+    try {
+        return realpathSync(join(tree, '.trail')) === realpathSync(home);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The Trail checkout a link on the way from the Trail home down to `dir` leads into, or null. Only the folders from
+ * the Trail home down are looked at (the home, `learnings`, then below), and only the ones that are links.
+ */
+export function linkedIntoCheckout(dir, env = process.env) {
+    const home = trailHome(env);
+    const base = trailPath(env, 'learnings');
+    const rel = relative(base, resolve(dir));
+    if (rel.startsWith('..'))
+        return null;
+    const parts = [home, base, ...(rel ? rel.split(sep).map((_, i, all) => join(base, ...all.slice(0, i + 1))) : [])];
+    for (const at of parts) {
+        if (!isLink(at))
+            continue;
+        const tree = workTreeOf(landsAt(at));
+        if (tree && isDir(join(tree, '.trail')) && !isTrailHomeItself(tree, env))
+            return tree;
+    }
+    return null;
+}
+/** Throws when writing a learning in `dir` would land in a Trail checkout through a link. */
+export function refuseLinkedIntoCheckout(dir, env = process.env) {
+    const tree = linkedIntoCheckout(dir, env);
+    if (tree) {
+        throw new Error(`trail: ${trailPath(env, 'learnings')} is linked into the repo at ${tree}, which has a .trail folder; `
+            + 'a learning written there could be committed for the team. Trail won\'t write your own learnings through it. Remove the link to go on.');
+    }
+}
+//# sourceMappingURL=linked-learnings.js.map

package/dist/notes/linked-learnings.js.map

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

package/dist/notes/replace.d.ts

@@ -0,0 +1,14 @@
+import { type Note } from "./notes.js";
+/**
+ * The learning `ref` (an id or a file name) names among `notes`, or the lines
+ * that say why a new learning can't replace it. A learning just for you never
+ * replaces one added to the repo: nobody else would see the change.
+ */
+export declare function learningToReplace(notes: Note[], ref: string, personal: boolean): {
+    note: Note;
+} | {
+    error: string[];
+};
+/** `· id l-3f9a21`, and what it replaces: `· id l-3f9a21 · replaces Maya's learning from Oct 8 (l-0a1b2c)`. */
+export declare function savedIdLine(saved: Note[], replaced?: Note): string;
+//# sourceMappingURL=replace.d.ts.map

package/dist/notes/replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../../src/notes/replace.ts"],"names":[],"mappings":"AAMA,OAAO,EAAuC,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAK5E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBrH;AAED,+GAA+G;AAC/G,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAGlE"}

package/dist/notes/replace.js

@@ -0,0 +1,38 @@
+/**
+ * `trail note --replaces <id>`: which learning a new one replaces, and what
+ * the command says about it. The old file is never edited: the new one names
+ * it, and from then on only the newest is read (`liveLearnings`).
+ */
+import { asLearningId, findLearning } from "./learning-fields.js";
+import { notePlace, shortDate, whoseLearning } from "./notes.js";
+/** How many learnings an unknown id lists, newest first. */
+const LISTED = 5;
+/**
+ * The learning `ref` (an id or a file name) names among `notes`, or the lines
+ * that say why a new learning can't replace it. A learning just for you never
+ * replaces one added to the repo: nobody else would see the change.
+ */
+export function learningToReplace(notes, ref, personal) {
+    const note = findLearning(notes, ref);
+    if (!note) {
+        const shown = ref.replace(/\s+/g, " ").trim().slice(0, 80);
+        const head = asLearningId(ref) ? `✗ no learning here has the id ${shown}` : `✗ no learning here is called ${shown}`;
+        const newest = notes.slice(0, LISTED).map((n) => `  ${n.id}  ${notePlace(n)}`);
+        return { error: newest.length ? [head, "  learnings here, newest first:", ...newest] : [head, "  this repo has no learnings yet"] };
+    }
+    if (personal && note.scope !== "personal") {
+        return {
+            error: [
+                "✗ a learning just for you can't replace one added to this repo: your teammates would still get the old one.",
+                "  Save it for the repo (leave out --personal), or leave out --replaces.",
+            ],
+        };
+    }
+    return { note };
+}
+/** `· id l-3f9a21`, and what it replaces: `· id l-3f9a21 · replaces Maya's learning from Oct 8 (l-0a1b2c)`. */
+export function savedIdLine(saved, replaced) {
+    const ids = [...new Set(saved.map((n) => n.id))].join(", ");
+    return replaced ? `· id ${ids} · replaces ${whoseLearning(replaced)} from ${shortDate(replaced.date)} (${replaced.id})` : `· id ${ids}`;
+}
+//# sourceMappingURL=replace.js.map

package/dist/notes/replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../src/notes/replace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,GAAW,EAAE,QAAiB;IAC7E,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC,CAAC,gCAAgC,KAAK,EAAE,CAAC;QACpH,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,iCAAiC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,kCAAkC,CAAC,EAAE,CAAC;IACtI,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO;YACL,KAAK,EAAE;gBACL,6GAA6G;gBAC7G,yEAAyE;aAC1E;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAe;IACxD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,eAAe,aAAa,CAAC,QAAQ,CAAC,SAAS,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;AAC1I,CAAC"}

package/dist/notes/repo-notes-dir.d.ts

@@ -0,0 +1,2 @@
+export declare function repoNotesDir(repoKey: string, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=repo-notes-dir.d.ts.map

package/dist/notes/repo-notes-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-notes-dir.d.ts","sourceRoot":"","sources":["../../src/notes/repo-notes-dir.ts"],"names":[],"mappings":"AASA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAM7E"}

package/dist/notes/repo-notes-dir.js

@@ -0,0 +1,16 @@
+/**
+ * A repo's personal learnings folder from its key, under the Trail home
+ * (`<trail home>/repos/<key>/notes`, phase 0's layout), for code that has a
+ * repo key but no checkout (b3's wall lessons). Every part of the key must be
+ * a plain folder name, so a key can't walk out of `repos/`.
+ */
+import { trailPath } from "../util/private-fs.js";
+import { flatLine } from "./flatten.js";
+export function repoNotesDir(repoKey, env) {
+    const parts = String(repoKey ?? "").split("/");
+    if (!parts.length || parts.some((p) => !/^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/.test(p) || p.includes(".."))) {
+        throw new Error(`trail: not a repo key: ${flatLine(repoKey, 60)}`);
+    }
+    return trailPath(env, "repos", ...parts, "notes");
+}
+//# sourceMappingURL=repo-notes-dir.js.map

package/dist/notes/repo-notes-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-notes-dir.js","sourceRoot":"","sources":["../../src/notes/repo-notes-dir.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,GAAuB;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/skills/anchors-cli.d.ts

@@ -0,0 +1,33 @@
+export declare const MAX_SRC_FILES = 400;
+export declare const MAX_SRC_BYTES: number;
+/** One CLI program of the checkout: its bin name, its package folder and its bin target (the source folder is found only when scanning). */
+export interface Cli {
+    prog: string;
+    pkgDir: string;
+    target: string;
+}
+/** The bins of the nearest package.json from the step's folder up to the checkout: name to target. null when none or unreadable. */
+export declare function binsNear(checkout: string, dir: string): {
+    pkgDir: string;
+    bins: Map<string, string>;
+} | null;
+/** The folder a program's commands are registered in: `src/`, else its bin target's folder, inside the package. */
+export declare function srcOf(pkgDir: string, target: string): string | null;
+/**
+ * The names registered with `.command('x'`, `new Command('x'`, `createCommand('x'`, `.alias('x')` and an `.aliases` array in `text` (each
+ * literal's first word), into `out`. false when one isn't a plain string literal, or a default command exists: then
+ * any word may be the CLI's, and nothing is judged.
+ */
+export declare function registrations(text: string, out: Set<string>): boolean;
+/**
+ * The names the program registers, or null when not known. `scan: false` (SessionStart) reads only the cache, and
+ * only an entry under a day old; `scan: true` walks the files (stat only) and reads them only when the signature
+ * moved, then writes the cache. Past the deadline: null, nothing written.
+ */
+export declare function cliNames(cli: Cli, checkout: string, env: NodeJS.ProcessEnv, opts: {
+    scan: boolean;
+    deadline: number;
+}): string[] | null;
+/** Gone only when at least 3 other registrations were found, none dynamic, and `x` isn't among them (P23). */
+export declare function subcommandGone(names: string[] | null, x: string): boolean;
+//# sourceMappingURL=anchors-cli.d.ts.map

package/dist/skills/anchors-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors-cli.d.ts","sourceRoot":"","sources":["../../src/skills/anchors-cli.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,aAAa,QAAkB,CAAC;AAW7C,4IAA4I;AAC5I,MAAM,WAAW,GAAG;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAKrE,oIAAoI;AACpI,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAoB5G;AAED,mHAAmH;AACnH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CA6BrE;AAsGD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAoBvI;AAED,8GAA8G;AAC9G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAIzE"}