@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/openalex/works.js

@@ -0,0 +1,267 @@
+/**
+ * @owner   src/adapters/openalex/works.ts
+ * @does    Register agent-facing OpenAlex work search and detail commands.
+ * @needs   Public OpenAlex API, TypeScript adapter loader, work id/DOI normalization.
+ * @feeds   surface coverage ledger, scholarly work command surface, agent-readable OpenAlex rows.
+ * @breaks  OpenAlex API envelope drift, weak DOI/id parsing, or abstract reconstruction errors degrade research lookup.
+ */
+import { cli, Strategy } from "../../registry.js";
+const OPENALEX_BASE = "https://api.openalex.org";
+const WORK_ID_RE = /^W\d{4,}$/;
+const DOI_RE = /^10\.\S+$/;
+const SEARCH_SELECT = [
+    "id",
+    "doi",
+    "title",
+    "publication_year",
+    "cited_by_count",
+    "authorships",
+    "primary_location",
+    "open_access",
+    "type",
+].join(",");
+const WORK_SELECT = [
+    "id",
+    "doi",
+    "title",
+    "publication_year",
+    "publication_date",
+    "cited_by_count",
+    "authorships",
+    "primary_location",
+    "open_access",
+    "type",
+    "referenced_works",
+    "language",
+    "abstract_inverted_index",
+].join(",");
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+export function requireOpenAlexString(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`openalex ${label} cannot be empty.`);
+    return text;
+}
+export function requireOpenAlexLimit(value, fallback = 20) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 200) {
+        throw new Error(`openalex limit must be an integer in [1, 200]. Got: ${String(value)}`);
+    }
+    return n;
+}
+export function bareOpenAlexId(value) {
+    return stringField(value)
+        .trim()
+        .replace(/^https?:\/\/(?:api\.)?openalex\.org\//i, "")
+        .replace(/^works\//i, "");
+}
+export function bareDoi(value) {
+    return stringField(value)
+        .trim()
+        .replace(/^https?:\/\/(?:dx\.)?doi\.org\//i, "");
+}
+export function requireOpenAlexWorkRef(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        throw new Error("openalex work id is required.");
+    const openAlexUrl = raw.match(/^https?:\/\/(?:api\.)?openalex\.org\/(?:works\/)?([A-Za-z]\d+)/i);
+    if (openAlexUrl) {
+        const id = openAlexUrl[1].toUpperCase();
+        if (!id.startsWith("W"))
+            throw new Error(`openalex id must be a Work id, got ${id}.`);
+        return id;
+    }
+    const upper = raw.toUpperCase();
+    if (WORK_ID_RE.test(upper))
+        return upper;
+    if (/^doi:/i.test(raw)) {
+        const doi = raw.replace(/^doi:/i, "").trim();
+        if (DOI_RE.test(doi))
+            return `doi:${doi}`;
+    }
+    const doiUrl = raw.match(/^https?:\/\/(?:dx\.)?doi\.org\/(.+)$/i);
+    if (doiUrl && DOI_RE.test(doiUrl[1]))
+        return `doi:${doiUrl[1]}`;
+    if (DOI_RE.test(raw))
+        return `doi:${raw}`;
+    throw new Error(`openalex work id "${raw}" is not recognised.`);
+}
+export function reconstructOpenAlexAbstract(index) {
+    if (!index || typeof index !== "object")
+        return "";
+    const positions = [];
+    for (const [token, values] of Object.entries(index)) {
+        if (!Array.isArray(values))
+            continue;
+        for (const pos of values) {
+            if (Number.isInteger(pos) && pos >= 0 && pos < 100_000) {
+                positions[pos] = token;
+            }
+        }
+    }
+    return positions.filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
+}
+function appendMailto(url) {
+    const mailto = process.env.OPENALEX_MAILTO?.trim();
+    if (!mailto)
+        return url;
+    return `${url}${url.includes("?") ? "&" : "?"}mailto=${encodeURIComponent(mailto)}`;
+}
+function firstAuthor(work) {
+    return Array.isArray(work.authorships) && work.authorships.length > 0
+        ? stringField(work.authorships[0]?.author?.display_name).trim()
+        : "";
+}
+function authors(work) {
+    return Array.isArray(work.authorships)
+        ? work.authorships
+            .map((item) => stringField(item.author?.display_name).trim())
+            .filter(Boolean)
+            .join(", ")
+        : "";
+}
+function venue(work) {
+    return stringField(work.primary_location?.source?.display_name).trim();
+}
+export function mapOpenAlexSearchRows(works, limit) {
+    return works.slice(0, limit).map((work, index) => {
+        const id = bareOpenAlexId(work.id);
+        return {
+            rank: index + 1,
+            id,
+            title: stringField(work.title).trim(),
+            year: numberField(work.publication_year),
+            citations: numberField(work.cited_by_count),
+            firstAuthor: firstAuthor(work),
+            venue: venue(work),
+            openAccess: Boolean(work.open_access?.is_oa),
+            type: stringField(work.type).trim(),
+            doi: bareDoi(work.doi),
+            url: id ? `https://openalex.org/${id}` : "",
+        };
+    });
+}
+export function mapOpenAlexWorkRow(work) {
+    const id = bareOpenAlexId(work.id);
+    if (!id)
+        throw new Error("OpenAlex returned no work record.");
+    return {
+        id,
+        title: stringField(work.title).trim(),
+        type: stringField(work.type).trim(),
+        year: numberField(work.publication_year),
+        date: stringField(work.publication_date).trim(),
+        language: stringField(work.language).trim(),
+        authors: authors(work),
+        venue: venue(work),
+        citations: numberField(work.cited_by_count),
+        openAccess: Boolean(work.open_access?.is_oa),
+        openAccessUrl: stringField(work.open_access?.oa_url).trim(),
+        referencedCount: Array.isArray(work.referenced_works)
+            ? work.referenced_works.length
+            : null,
+        doi: bareDoi(work.doi),
+        abstract: reconstructOpenAlexAbstract(work.abstract_inverted_index),
+        url: `https://openalex.org/${id}`,
+    };
+}
+async function fetchOpenAlex(url, label) {
+    const response = await fetch(appendMailto(url), {
+        headers: {
+            "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "openalex",
+    name: "search",
+    description: "Search OpenAlex Works by keyword",
+    domain: "api.openalex.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search text",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max works" },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "title",
+        "year",
+        "citations",
+        "firstAuthor",
+        "venue",
+        "openAccess",
+        "type",
+        "doi",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireOpenAlexString(kwargs.query, "query");
+        const limit = requireOpenAlexLimit(kwargs.limit);
+        const body = (await fetchOpenAlex(`${OPENALEX_BASE}/works?search=${encodeURIComponent(query)}&per-page=${limit}&select=${SEARCH_SELECT}`, "openalex search"));
+        const rows = mapOpenAlexSearchRows(Array.isArray(body.results) ? body.results : [], limit);
+        if (rows.length === 0)
+            throw new Error(`No OpenAlex works matched "${query}".`);
+        return rows;
+    },
+});
+cli({
+    site: "openalex",
+    name: "work",
+    description: "Fetch a single OpenAlex Work",
+    domain: "api.openalex.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "OpenAlex Work id or DOI",
+        },
+    ],
+    columns: [
+        "id",
+        "title",
+        "type",
+        "year",
+        "date",
+        "language",
+        "authors",
+        "venue",
+        "citations",
+        "openAccess",
+        "openAccessUrl",
+        "referencedCount",
+        "doi",
+        "abstract",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const ref = requireOpenAlexWorkRef(kwargs.id);
+        const work = (await fetchOpenAlex(`${OPENALEX_BASE}/works/${encodeURIComponent(ref)}?select=${WORK_SELECT}`, "openalex work"));
+        return [mapOpenAlexWorkRow(work)];
+    },
+});
+//# sourceMappingURL=works.js.map

package/dist/adapters/openalex/works.js.map

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

package/dist/adapters/openfda/records.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @owner   src/adapters/openfda/records.ts
+ * @does    Register agent-facing openFDA drug label and food recall commands.
+ * @needs   openFDA public API, bounded limits, explicit query encoding.
+ * @feeds   surface coverage ledger, FDA drug label rows, FDA food recall rows.
+ * @breaks  openFDA API drift, malformed Lucene filters, or silent empty rows hide FDA records.
+ */
+export declare function requireOpenfdaLimit(value: unknown, fallback: number, max: number): number;
+export declare function firstOpenfdaValue(value: unknown): unknown;
+export declare function joinOpenfdaValues(value: unknown, max?: number): string | null;
+export declare function buildFoodRecallSearch(filters: {
+    classification?: unknown;
+    query?: unknown;
+    status?: unknown;
+}): string;
+export declare function mapDrugLabelRows(rows: Array<Record<string, unknown>>): Array<Record<string, unknown>>;
+export declare function mapFoodRecallRows(rows: Array<Record<string, unknown>>): Array<Record<string, unknown>>;
+//# sourceMappingURL=records.d.ts.map

package/dist/adapters/openfda/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/adapters/openfda/records.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CAQR;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAI,GAAG,MAAM,GAAG,IAAI,CAGxE;AAYD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAQT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBhC;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmBhC"}

package/dist/adapters/openfda/records.js

@@ -0,0 +1,209 @@
+/**
+ * @owner   src/adapters/openfda/records.ts
+ * @does    Register agent-facing openFDA drug label and food recall commands.
+ * @needs   openFDA public API, bounded limits, explicit query encoding.
+ * @feeds   surface coverage ledger, FDA drug label rows, FDA food recall rows.
+ * @breaks  openFDA API drift, malformed Lucene filters, or silent empty rows hide FDA records.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://api.fda.gov";
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`openfda ${label} cannot be empty.`);
+    return text;
+}
+export function requireOpenfdaLimit(value, fallback, max) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > max) {
+        throw new Error(`openfda limit must be an integer in [1, ${max}].`);
+    }
+    return limit;
+}
+export function firstOpenfdaValue(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return null;
+    const first = value[0];
+    return typeof first === "string" ? first.trim() || null : (first ?? null);
+}
+export function joinOpenfdaValues(value, max = 5) {
+    if (!Array.isArray(value) || value.length === 0)
+        return null;
+    return value.slice(0, max).map(String).join(", ");
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function stringOrNull(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+export function buildFoodRecallSearch(filters) {
+    const parts = [];
+    if (filters.query)
+        parts.push(String(filters.query).trim());
+    if (filters.status)
+        parts.push(`status:"${String(filters.status).trim()}"`);
+    if (filters.classification) {
+        parts.push(`classification:"${String(filters.classification).trim()}"`);
+    }
+    return parts.map((part) => encodeURIComponent(part)).join("+AND+");
+}
+export function mapDrugLabelRows(rows) {
+    return rows.map((row, index) => {
+        const openfda = objectField(row.openfda);
+        const pharmClass = firstOpenfdaValue(openfda.pharm_class_epc) ??
+            firstOpenfdaValue(openfda.pharm_class_moa) ??
+            firstOpenfdaValue(openfda.pharm_class_cs) ??
+            firstOpenfdaValue(openfda.pharm_class_pe);
+        return {
+            rank: index + 1,
+            id: stringOrNull(row.id),
+            brandName: firstOpenfdaValue(openfda.brand_name),
+            genericName: firstOpenfdaValue(openfda.generic_name),
+            manufacturer: firstOpenfdaValue(openfda.manufacturer_name),
+            productType: firstOpenfdaValue(openfda.product_type),
+            route: joinOpenfdaValues(openfda.route),
+            productNdc: firstOpenfdaValue(openfda.product_ndc),
+            pharmClass,
+            purpose: firstOpenfdaValue(row.purpose),
+            indications: firstOpenfdaValue(row.indications_and_usage),
+            warnings: firstOpenfdaValue(row.warnings),
+            dosage: firstOpenfdaValue(row.dosage_and_administration),
+            effectiveTime: stringOrNull(row.effective_time),
+        };
+    });
+}
+export function mapFoodRecallRows(rows) {
+    return rows.map((row, index) => ({
+        rank: index + 1,
+        recallNumber: stringOrNull(row.recall_number),
+        status: stringOrNull(row.status),
+        classification: stringOrNull(row.classification),
+        voluntary: stringOrNull(row.voluntary_mandated),
+        recallingFirm: stringOrNull(row.recalling_firm),
+        city: stringOrNull(row.city),
+        state: stringOrNull(row.state),
+        country: stringOrNull(row.country),
+        productDescription: stringOrNull(row.product_description),
+        reasonForRecall: stringOrNull(row.reason_for_recall),
+        productQuantity: stringOrNull(row.product_quantity),
+        distributionPattern: stringOrNull(row.distribution_pattern),
+        reportDate: stringOrNull(row.report_date),
+        recallInitiationDate: stringOrNull(row.recall_initiation_date),
+        terminationDate: stringOrNull(row.termination_date),
+    }));
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-openfda (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "openfda",
+    name: "drug-label",
+    description: "Search FDA drug labels by brand or generic name",
+    domain: "fda.gov",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Brand or generic drug name",
+        },
+        { name: "limit", type: "int", default: 5, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "brandName",
+        "genericName",
+        "manufacturer",
+        "productType",
+        "route",
+        "productNdc",
+        "pharmClass",
+        "purpose",
+        "indications",
+        "warnings",
+        "dosage",
+        "effectiveTime",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const limit = requireOpenfdaLimit(kwargs.limit, 5, 25);
+        const brand = encodeURIComponent(`openfda.brand_name:"${query}"`);
+        const generic = encodeURIComponent(`openfda.generic_name:"${query}"`);
+        const body = (await fetchJson(`${API_BASE}/drug/label.json?search=${brand}+OR+${generic}&limit=${limit}`, "openfda drug-label"));
+        const rows = mapDrugLabelRows(Array.isArray(body.results)
+            ? body.results
+            : []);
+        if (rows.length === 0) {
+            throw new Error(`openfda drug-label returned no rows for "${query}".`);
+        }
+        return rows;
+    },
+});
+cli({
+    site: "openfda",
+    name: "food-recall",
+    description: "Search FDA food recall and enforcement actions",
+    domain: "fda.gov",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "query", type: "str", description: "Free-text Lucene query" },
+        { name: "status", type: "str", description: "Recall status" },
+        {
+            name: "classification",
+            type: "str",
+            description: "Recall classification",
+        },
+        { name: "limit", type: "int", default: 10, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "recallNumber",
+        "status",
+        "classification",
+        "voluntary",
+        "recallingFirm",
+        "city",
+        "state",
+        "country",
+        "productDescription",
+        "reasonForRecall",
+        "productQuantity",
+        "distributionPattern",
+        "reportDate",
+        "recallInitiationDate",
+        "terminationDate",
+    ],
+    func: async (_page, kwargs) => {
+        const limit = requireOpenfdaLimit(kwargs.limit, 10, 100);
+        const search = buildFoodRecallSearch(kwargs);
+        const qs = search ? `search=${search}&limit=${limit}` : `limit=${limit}`;
+        const body = (await fetchJson(`${API_BASE}/food/enforcement.json?${qs}`, "openfda food-recall"));
+        const rows = mapFoodRecallRows(Array.isArray(body.results)
+            ? body.results
+            : []);
+        if (rows.length === 0) {
+            throw new Error("openfda food-recall returned no rows for the filter.");
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=records.js.map

package/dist/adapters/openfda/records.js.map

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

package/dist/adapters/openreview/papers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @owner   src/adapters/openreview/papers.ts
+ * @does    Register agent-facing OpenReview search, paper, author, venue, and reviews commands.
+ * @needs   Public api2.openreview.net notes API, forum/profile id validation, note content normalization.
+ * @feeds   surface coverage ledger, scholarly review workflow, agent-readable paper/review rows.
+ * @breaks  OpenReview API envelope drift, content.value parsing, or silent empty threads hide paper review state.
+ */
+interface OpenReviewContentValue {
+    value?: unknown;
+}
+type OpenReviewContent = Record<string, OpenReviewContentValue | undefined>;
+interface OpenReviewNote {
+    id?: unknown;
+    forum?: unknown;
+    cdate?: unknown;
+    pdate?: unknown;
+    invitations?: unknown;
+    signatures?: unknown;
+    content?: OpenReviewContent;
+}
+export declare function coerceOpenReviewInt(value: unknown): number;
+export declare function requireOpenReviewLimit(value: unknown, fallback: number, max: number): number;
+export declare function requireOpenReviewOffset(value: unknown, fallback?: number): number;
+export declare function requireForumId(value: unknown, label?: string): string;
+export declare function requireProfileId(value: unknown): string;
+export declare function readContent(content: OpenReviewContent | undefined, key: string): unknown;
+export declare function formatOpenReviewDate(value: unknown): string;
+export declare function absoluteOpenReviewPdf(value: unknown): string;
+export declare function mapOpenReviewNoteRow(note: OpenReviewNote): Record<string, unknown>;
+export declare function classifyReviewNote(note: OpenReviewNote, isRoot: boolean): string;
+export declare function authorFromSignatures(signatures: unknown): string;
+export declare function mapReviewThreadRows(root: OpenReviewNote, replies: OpenReviewNote[], forum: string, maxLength: number): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=papers.d.ts.map

package/dist/adapters/openreview/papers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"papers.d.ts","sourceRoot":"","sources":["../../../src/adapters/openreview/papers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,UAAU,sBAAsB;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC,CAAC;AAE5E,UAAU,cAAc;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAgBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI1D;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAS5E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAO,GAAG,MAAM,CASnE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO5D;AAUD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB;AAWD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,OAAO,GACd,MAAM,CAUR;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAMhE;AAkBD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmBhC"}