@lovrozagar/oat 0.1.0

package/dist/spec/conventions.d.ts

@@ -0,0 +1,103 @@
+/**
+ * What a list endpoint's query parameters and response envelope *mean*, derived from the
+ * document rather than assumed.
+ *
+ * Checks used to match on literal names — `"filter"`, `"page"`, `envelope.hasMore` — which made
+ * roughly half of them fire only against APIs that happened to share the fixture's spelling.
+ * Everywhere else they were skipped, and skipped silently, so a quiet run on an unfamiliar API
+ * read exactly like a clean one.
+ *
+ * Names are matched against the aliases real APIs actually use, and the shape of the declared
+ * schema breaks ties. Anything still ambiguous is left `undefined` — the check then reports that
+ * it did not apply, and `x-query` can state the answer outright.
+ */
+import type { CollectionShape } from "./collection.ts";
+import type { ParameterObject } from "./types.ts";
+/** How filter values are spelled. Determines what oat can express, not merely what it sends. */
+export type FilterGrammar = 
+/** `field.op.value`, with `and(...)`/`or(...)` — PostgREST and friends. */
+"postgrest"
+/** `field=op:value`, e.g. `?price=gt:10`. */
+ | "colon"
+/** One parameter per field, equality only — `?status=active`. */
+ | "equality";
+/**
+ * How a sort direction is spelled.
+ *
+ * The role of the parameter and the *grammar* of its value are separate problems, and generalising
+ * only the first is a half-measure: an API that names the parameter `sort` but expects `-name`
+ * receives `name.asc`, ignores or rejects it, and reads as a backend with broken sorting rather
+ * than one speaking a dialect oat cannot write.
+ */
+export type SortGrammar = 
+/** `field.asc` / `field.desc`, comma-separated — PostgREST. */
+"dotted"
+/** `-field` for descending, bare for ascending — JSON:API. */
+ | "prefixed"
+/** `field:asc` / `field:desc`. */
+ | "colon"
+/** `field asc` / `field desc`, as SQL writes it. */
+ | "spaced";
+/** How a sparse fieldset is spelled. */
+export type SelectGrammar = 
+/** `id,name` — comma-separated field names. */
+"csv"
+/** `fields[type]=id,name` — JSON:API's per-type bracket form. */
+ | "bracketed";
+export interface QueryConventions {
+    /** Parameter carrying a filter expression, when the endpoint has one. */
+    filter?: string;
+    /** Parameter selecting sort order. */
+    order?: string;
+    /** Parameter selecting a sparse fieldset. */
+    select?: string;
+    /** Free-text search parameter. */
+    search?: string;
+    /** Page-size parameter. */
+    limit?: string;
+    /** 1-based page number. */
+    page?: string;
+    /** Zero-based row offset, where the API pages by offset rather than page number. */
+    offset?: string;
+    /** Opaque forward cursor. */
+    cursor?: string;
+    grammar: FilterGrammar;
+    /** How sort directions are written for the `order` parameter. */
+    sortGrammar: SortGrammar;
+    /** How a sparse fieldset is written for the `select` parameter. */
+    selectGrammar: SelectGrammar;
+    /**
+     * Response header carrying RFC 8288 pagination links, when the document declares one.
+     *
+     * Its presence changes how "are there more pages" is answered: under Link pagination the
+     * *absence* of `rel="next"` means no, so a response with no header at all is a definite
+     * "false" rather than an unknown. Without knowing the API publishes such a header, the two
+     * are indistinguishable and the check that asks has to stand down.
+     */
+    linkHeader?: string;
+    /** Where each is spelled in the response envelope, when the schema declares one. */
+    envelope: {
+        total?: string;
+        hasMore?: string;
+        nextCursor?: string;
+        page?: string;
+        limit?: string;
+    };
+}
+export declare function deriveQueryConventions(parameters: readonly ParameterObject[], collection: CollectionShape | null, declared?: {
+    grammar?: string;
+}, onGuess?: (message: string) => void, 
+/** Response headers the success response declares, by name. */
+responseHeaders?: readonly string[]): QueryConventions;
+/** Renders one filter term in whichever grammar the endpoint speaks. */
+export declare function filterTerm(conventions: QueryConventions, field: string, op: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "like", value: string | number): Record<string, string> | null;
+/** Renders a sort term in whichever grammar the endpoint speaks. */
+export declare function sortTerm(conventions: QueryConventions, field: string, direction: "asc" | "desc"): string;
+/**
+ * Renders a sparse fieldset, returning the parameter name alongside the value.
+ *
+ * JSON:API puts the resource type in the parameter name rather than the value, so the two cannot
+ * be chosen independently — which is why this returns a pair rather than a string.
+ */
+export declare function selectTerm(conventions: QueryConventions, fields: readonly string[], resource: string): Record<string, string> | null;
+//# sourceMappingURL=conventions.d.ts.map

package/dist/spec/conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../../src/spec/conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAA;AAE/D,gGAAgG;AAChG,MAAM,MAAM,aAAa;AACxB,2EAA2E;AACzE,WAAW;AACb,6CAA6C;GAC3C,OAAO;AACT,iEAAiE;GAC/D,UAAU,CAAA;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW;AACtB,+DAA+D;AAC7D,QAAQ;AACV,8DAA8D;GAC5D,UAAU;AACZ,kCAAkC;GAChC,OAAO;AACT,oDAAoD;GAClD,QAAQ,CAAA;AAEX,wCAAwC;AACxC,MAAM,MAAM,aAAa;AACxB,+CAA+C;AAC7C,KAAK;AACP,iEAAiE;GAC/D,WAAW,CAAA;AAEd,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,CAAA;IACtB,iEAAiE;IACjE,WAAW,EAAE,WAAW,CAAA;IACxB,mEAAmE;IACnE,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,QAAQ,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACD;AAkJD,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,QAAQ,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;AACnC,+DAA+D;AAC/D,eAAe,GAAE,SAAS,MAAM,EAAO,GACrC,gBAAgB,CAkElB;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CACzB,WAAW,EAAE,gBAAgB,EAC7B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,EACvD,KAAK,EAAE,MAAM,GAAG,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAc/B;AAGD,oEAAoE;AACpE,wBAAgB,QAAQ,CACvB,WAAW,EAAE,gBAAgB,EAC7B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,KAAK,GAAG,MAAM,GACvB,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/B"}

package/dist/spec/conventions.js

@@ -0,0 +1,275 @@
+/**
+ * What a list endpoint's query parameters and response envelope *mean*, derived from the
+ * document rather than assumed.
+ *
+ * Checks used to match on literal names — `"filter"`, `"page"`, `envelope.hasMore` — which made
+ * roughly half of them fire only against APIs that happened to share the fixture's spelling.
+ * Everywhere else they were skipped, and skipped silently, so a quiet run on an unfamiliar API
+ * read exactly like a clean one.
+ *
+ * Names are matched against the aliases real APIs actually use, and the shape of the declared
+ * schema breaks ties. Anything still ambiguous is left `undefined` — the check then reports that
+ * it did not apply, and `x-query` can state the answer outright.
+ */
+/*
+ * Aliases seen across real APIs. Order matters only for readability; a parameter is matched
+ * case-insensitively and with separators normalised, so `perPage`, `per_page` and `PerPage` are
+ * one entry.
+ */
+const ALIASES = {
+    cursor: ["cursor", "after", "starting_after", "next", "page_token", "continuation"],
+    filter: ["filter", "where", "query", "conditions"],
+    limit: ["limit", "per_page", "page_size", "pagesize", "count", "max_results", "top", "size"],
+    offset: ["offset", "skip", "start", "from"],
+    order: ["order", "order_by", "sort", "sort_by", "ordering"],
+    page: ["page", "page_number", "pagenum", "p"],
+    search: ["q", "search", "query_text", "term", "keyword", "text"],
+    select: ["select", "fields", "field", "include_fields", "projection", "only"],
+};
+function normalise(name) {
+    return name
+        /* A bracketed suffix is a *value* carried in the parameter name — `fields[articles]`,
+         * `filter[status]` — not part of the role's name. Matching the whole string against the
+         * alias list would fail to recognise the role at all, and the check that needed it would
+         * report itself inapplicable against an API that plainly supports it. */
+        .replace(/\[[^\]]*\]$/, "")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase()
+        .replace(/[-\s]/g, "_");
+}
+function schemaOf(parameter) {
+    return parameter.schema ?? {};
+}
+function isInteger(parameter) {
+    const type = schemaOf(parameter).type;
+    return type === "integer" || type === "number";
+}
+/**
+ * `limit` and `page` are both bare integers, and several APIs spell one of them with a word that
+ * belongs to the other's alias list — `count` most notoriously. The declared schema settles it:
+ * a page size is the one with an upper bound, a page number the one that starts at 1.
+ */
+function resolvePagingRoles(candidates) {
+    const roles = {};
+    for (const parameter of candidates) {
+        if (!isInteger(parameter))
+            continue;
+        const name = normalise(parameter.name);
+        const schema = schemaOf(parameter);
+        const hasMaximum = typeof schema.maximum === "number";
+        const startsAtOne = schema.minimum === 1;
+        const hasDefault = schema.default !== undefined;
+        if (roles.limit === undefined && ALIASES.limit.includes(name)) {
+            /* `count` is a page size only when it reads like one; otherwise it is a total. */
+            if (name !== "count" || hasMaximum || hasDefault) {
+                roles.limit = parameter.name;
+                continue;
+            }
+        }
+        if (roles.page === undefined && ALIASES.page.includes(name) && !hasMaximum) {
+            roles.page = parameter.name;
+            continue;
+        }
+        if (roles.offset === undefined && ALIASES.offset.includes(name)) {
+            roles.offset = parameter.name;
+            continue;
+        }
+        /* Unnamed but unmistakable: a bounded integer with a default is a page size. */
+        if (roles.limit === undefined && hasMaximum && hasDefault)
+            roles.limit = parameter.name;
+        else if (roles.page === undefined && startsAtOne && !hasMaximum)
+            roles.page = parameter.name;
+    }
+    return roles;
+}
+/**
+ * Infers the filter grammar from the parameter's declared examples, which is where APIs
+ * describing a grammar almost always demonstrate it. Defaults to one-parameter-per-field
+ * equality — the assumption that holds for the widest range of APIs, and the one whose checks
+ * degrade most gracefully when wrong.
+ */
+function inferGrammar(filter) {
+    if (filter === undefined)
+        return "equality";
+    const schema = schemaOf(filter);
+    const samples = [
+        ...(Array.isArray(schema.examples) ? schema.examples : []),
+        ...(schema.example === undefined ? [] : [schema.example]),
+        ...(typeof filter.description === "string" ? [filter.description] : []),
+    ].filter((value) => typeof value === "string");
+    const text = samples.join(" ");
+    /* Named outright in the description is the strongest signal — documents that describe a
+     * grammar almost always name it before demonstrating it. */
+    if (/postgrest/i.test(text))
+        return "postgrest";
+    if (/\b[\w.]+\.(eq|neq|gt|gte|lt|lte|like|ilike|in|nin|is|contains)\b/.test(text))
+        return "postgrest";
+    /* `field.op.value` written as a schema rather than an instance. */
+    if (/\bfield\.op\.value\b/i.test(text))
+        return "postgrest";
+    if (/\b[\w.]+=(eq|neq|gt|gte|lt|lte|like|in):/.test(text))
+        return "colon";
+    return "equality";
+}
+/**
+ * Infers the sort grammar from what the document demonstrates.
+ *
+ * Descriptions and examples are where an API shows its hand — `sort=-created_at` is unambiguous,
+ * and so is `field:desc`. Defaults to the dotted form, which is the most common and, being an
+ * unrecognised token rather than a wrong direction, fails loudly rather than silently sorting
+ * backwards when wrong.
+ */
+function inferSortGrammar(order) {
+    if (order === undefined)
+        return "dotted";
+    const schema = order.schema ?? {};
+    const text = [
+        ...(Array.isArray(schema.examples) ? schema.examples : []),
+        ...(schema.example === undefined ? [] : [schema.example]),
+        ...(typeof order.description === "string" ? [order.description] : []),
+    ]
+        .filter((value) => typeof value === "string")
+        .join(" ");
+    if (/\b[\w.]+\.(asc|desc)\b/i.test(text))
+        return "dotted";
+    if (/\b[\w.]+:(asc|desc)\b/i.test(text))
+        return "colon";
+    if (/\b[\w.]+\s+(asc|desc)\b/i.test(text))
+        return "spaced";
+    /* A leading minus is the JSON:API convention; the "-" must precede a field name, not merely
+     * appear in prose, so the match is anchored to a token boundary. */
+    if (/(^|[\s,="'])-[a-z_][\w.]*/i.test(text) && /descend/i.test(text))
+        return "prefixed";
+    if (/(^|[\s,="'])-[a-z_][\w.]*/i.test(text))
+        return "prefixed";
+    return "dotted";
+}
+/** Infers how a sparse fieldset is written. `fields[type]=` is JSON:API's and unmistakable. */
+function inferSelectGrammar(select) {
+    if (select === undefined)
+        return "csv";
+    if (/\[[^\]]+\]$/.test(select.name))
+        return "bracketed";
+    const description = typeof select.description === "string" ? select.description : "";
+    return /fields\[[^\]]+\]/.test(description) ? "bracketed" : "csv";
+}
+export function deriveQueryConventions(parameters, collection, declared, onGuess, 
+/** Response headers the success response declares, by name. */
+responseHeaders = []) {
+    const query = parameters.filter((p) => p.in === "query");
+    const byRole = (role) => query.find((p) => ALIASES[role].includes(normalise(p.name)))?.name;
+    const paging = resolvePagingRoles(query);
+    const filterName = byRole("filter");
+    const filterParam = query.find((p) => p.name === filterName);
+    const grammar = declared?.grammar === "postgrest" || declared?.grammar === "colon" || declared?.grammar === "equality"
+        ? declared.grammar
+        : inferGrammar(filterParam);
+    if (declared?.grammar === undefined &&
+        filterParam !== undefined &&
+        grammar === "equality" &&
+        schemaOf(filterParam).type === "string") {
+        /* A single free-text `filter` parameter almost never means equality-per-field; it means a
+         * grammar oat could not recognise. Saying so beats sending `?name=value` and reading the
+         * shrug that comes back as a defect. */
+        onGuess?.(`parameter "${filterParam.name}" takes a filter expression whose grammar could not be ` +
+            "recognised from its description or examples, so oat assumed one parameter per field. " +
+            'Declare it with x-query: { grammar: "postgrest" | "colon" | "equality" }');
+    }
+    const orderParam = query.find((p) => p.name === byRole("order"));
+    const selectParam = query.find((p) => p.name === byRole("select"));
+    const conventions = {
+        envelope: {},
+        grammar,
+        selectGrammar: inferSelectGrammar(selectParam),
+        sortGrammar: inferSortGrammar(orderParam),
+    };
+    const link = responseHeaders.find((name) => name.toLowerCase() === "link");
+    if (link !== undefined)
+        conventions.linkHeader = link;
+    if (filterName !== undefined)
+        conventions.filter = filterName;
+    const order = byRole("order");
+    if (order !== undefined)
+        conventions.order = order;
+    const select = byRole("select");
+    if (select !== undefined)
+        conventions.select = select;
+    const search = byRole("search");
+    if (search !== undefined)
+        conventions.search = search;
+    const cursor = byRole("cursor");
+    if (cursor !== undefined)
+        conventions.cursor = cursor;
+    if (paging.limit !== undefined)
+        conventions.limit = paging.limit;
+    if (paging.page !== undefined)
+        conventions.page = paging.page;
+    if (paging.offset !== undefined)
+        conventions.offset = paging.offset;
+    /* The envelope is already derived from the 200 schema when the shape was resolved — reuse it
+     * rather than matching on literal key names a second time. */
+    const pagination = collection?.pagination;
+    if (pagination?.countKey !== undefined)
+        conventions.envelope.total = pagination.countKey;
+    if (pagination?.hasMoreKey !== undefined)
+        conventions.envelope.hasMore = pagination.hasMoreKey;
+    if (pagination?.cursorKey !== undefined)
+        conventions.envelope.nextCursor = pagination.cursorKey;
+    if (pagination?.pageKey !== undefined)
+        conventions.envelope.page = pagination.pageKey;
+    if (pagination?.limitKey !== undefined)
+        conventions.envelope.limit = pagination.limitKey;
+    return conventions;
+}
+/** Renders one filter term in whichever grammar the endpoint speaks. */
+export function filterTerm(conventions, field, op, value) {
+    const parameter = conventions.filter;
+    switch (conventions.grammar) {
+        case "postgrest":
+            if (parameter === undefined)
+                return null;
+            return { [parameter]: `${field}.${op}.${value}` };
+        case "colon":
+            if (parameter === undefined)
+                return null;
+            return { [parameter]: `${field}=${op}:${value}` };
+        case "equality":
+            /* Only equality is expressible, so anything else has no representation and the check
+             * that wanted it must stand down rather than send something meaningless. */
+            return op === "eq" ? { [field]: String(value) } : null;
+    }
+}
+/** Renders a sort term in whichever grammar the endpoint speaks. */
+export function sortTerm(conventions, field, direction) {
+    switch (conventions.sortGrammar) {
+        case "dotted":
+            return `${field}.${direction}`;
+        case "colon":
+            return `${field}:${direction}`;
+        case "spaced":
+            return `${field} ${direction}`;
+        case "prefixed":
+            /* Ascending is the bare field name: there is no "+" form in this grammar, and sending
+             * one would be a token the API has never seen. */
+            return direction === "desc" ? `-${field}` : field;
+    }
+}
+/**
+ * Renders a sparse fieldset, returning the parameter name alongside the value.
+ *
+ * JSON:API puts the resource type in the parameter name rather than the value, so the two cannot
+ * be chosen independently — which is why this returns a pair rather than a string.
+ */
+export function selectTerm(conventions, fields, resource) {
+    const parameter = conventions.select;
+    if (parameter === undefined)
+        return null;
+    const value = fields.join(",");
+    if (conventions.selectGrammar === "csv")
+        return { [parameter]: value };
+    /* Already bracketed in the document — `fields[articles]` — so the name is used verbatim.
+     * Otherwise the resource name is inserted, which is what the grammar requires. */
+    const name = /\[[^\]]+\]$/.test(parameter) ? parameter : `${parameter}[${resource}]`;
+    return { [name]: value };
+}
+//# sourceMappingURL=conventions.js.map

package/dist/spec/conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.js","sourceRoot":"","sources":["../../src/spec/conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgFH;;;;GAIG;AACH,MAAM,OAAO,GAGT;IACH,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC;IACnF,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC;IAClD,KAAK,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC;IAC5F,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC;IAC3D,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC;IAC7C,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;IAChE,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,CAAC;CAC7E,CAAA;AAED,SAAS,SAAS,CAAC,IAAY;IAC9B,OAAO,IAAI;QACV;;;iFAGyE;SACxE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE;SACb,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,QAAQ,CAAC,SAA0B;IAC3C,OAAO,SAAS,CAAC,MAAM,IAAI,EAAE,CAAA;AAC9B,CAAC;AAED,SAAS,SAAS,CAAC,SAA0B;IAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAA;IACrC,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAC1B,UAA6B;IAE7B,MAAM,KAAK,GAAuD,EAAE,CAAA;IAEpE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;YAAE,SAAQ;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;QAClC,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAA;QACrD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,KAAK,CAAC,CAAA;QACxC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,CAAA;QAE/C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,kFAAkF;YAClF,IAAI,IAAI,KAAK,OAAO,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;gBAClD,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAA;gBAC5B,SAAQ;YACT,CAAC;QACF,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5E,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;YAC3B,SAAQ;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAA;YAC7B,SAAQ;QACT,CAAC;QACD,gFAAgF;QAChF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,IAAI,UAAU;YAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAA;aAClF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;IAC7F,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,MAAmC;IACxD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAA;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG;QACf,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAA;IAE/D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B;gEAC4D;IAC5D,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAA;IAC/C,IAAI,kEAAkE,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAA;IACrG,mEAAmE;IACnE,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAA;IAC1D,IAAI,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IACzE,OAAO,UAAU,CAAA;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,KAAkC;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IACjC,MAAM,IAAI,GAAG;QACZ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,GAAG,CAAC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE;SACC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;SAC7D,IAAI,CAAC,GAAG,CAAC,CAAA;IAEX,IAAI,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAA;IACzD,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IACvD,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC1D;wEACoE;IACpE,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IACvF,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IAC9D,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED,+FAA+F;AAC/F,SAAS,kBAAkB,CAAC,MAAmC;IAC9D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAA;IACvD,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACpF,OAAO,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,UAAsC,EACtC,UAAkC,EAClC,QAA+B,EAC/B,OAAmC;AACnC,+DAA+D;AAC/D,kBAAqC,EAAE;IAEvC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,CAAC,IAA0B,EAAsB,EAAE,CACjE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;IAEnE,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAA;IAE5D,MAAM,OAAO,GACZ,QAAQ,EAAE,OAAO,KAAK,WAAW,IAAI,QAAQ,EAAE,OAAO,KAAK,OAAO,IAAI,QAAQ,EAAE,OAAO,KAAK,UAAU;QACrG,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;IAE7B,IACC,QAAQ,EAAE,OAAO,KAAK,SAAS;QAC/B,WAAW,KAAK,SAAS;QACzB,OAAO,KAAK,UAAU;QACtB,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,QAAQ,EACtC,CAAC;QACF;;gDAEwC;QACxC,OAAO,EAAE,CACR,cAAc,WAAW,CAAC,IAAI,yDAAyD;YACtF,uFAAuF;YACvF,0EAA0E,CAC3E,CAAA;IACF,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IAElE,MAAM,WAAW,GAAqB;QACrC,QAAQ,EAAE,EAAE;QACZ,OAAO;QACP,aAAa,EAAE,kBAAkB,CAAC,WAAW,CAAC;QAC9C,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC;KACzC,CAAA;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAA;IAC1E,IAAI,IAAI,KAAK,SAAS;QAAE,WAAW,CAAC,UAAU,GAAG,IAAI,CAAA;IAErD,IAAI,UAAU,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,UAAU,CAAA;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7B,IAAI,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAA;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAA;IACrD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAChE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAEnE;kEAC8D;IAC9D,MAAM,UAAU,GAAG,UAAU,EAAE,UAAU,CAAA;IACzC,IAAI,UAAU,EAAE,QAAQ,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAA;IACxF,IAAI,UAAU,EAAE,UAAU,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,UAAU,CAAA;IAC9F,IAAI,UAAU,EAAE,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC,SAAS,CAAA;IAC/F,IAAI,UAAU,EAAE,OAAO,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,CAAC,IAAI,GAAG,UAAU,CAAC,OAAO,CAAA;IACrF,IAAI,UAAU,EAAE,QAAQ,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAA;IAExF,OAAO,WAAW,CAAA;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CACzB,WAA6B,EAC7B,KAAa,EACb,EAAuD,EACvD,KAAsB;IAEtB,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAA;IACpC,QAAQ,WAAW,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,WAAW;YACf,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YACxC,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,EAAE,IAAI,KAAK,EAAE,EAAE,CAAA;QAClD,KAAK,OAAO;YACX,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YACxC,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,EAAE,IAAI,KAAK,EAAE,EAAE,CAAA;QAClD,KAAK,UAAU;YACd;wFAC4E;YAC5E,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACxD,CAAC;AACF,CAAC;AAGD,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CACvB,WAA6B,EAC7B,KAAa,EACb,SAAyB;IAEzB,QAAQ,WAAW,CAAC,WAAW,EAAE,CAAC;QACjC,KAAK,QAAQ;YACZ,OAAO,GAAG,KAAK,IAAI,SAAS,EAAE,CAAA;QAC/B,KAAK,OAAO;YACX,OAAO,GAAG,KAAK,IAAI,SAAS,EAAE,CAAA;QAC/B,KAAK,QAAQ;YACZ,OAAO,GAAG,KAAK,IAAI,SAAS,EAAE,CAAA;QAC/B,KAAK,UAAU;YACd;8DACkD;YAClD,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IACnD,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACzB,WAA6B,EAC7B,MAAyB,EACzB,QAAgB;IAEhB,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAA;IACpC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,WAAW,CAAC,aAAa,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAA;IACtE;sFACkF;IAClF,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,GAAG,CAAA;IACpF,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC"}

package/dist/spec/extensions.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Reads the `x-*` meta tags documented in the README.
+ *
+ * Every reader follows the same contract: explicit tag → heuristic → `null` plus a recorded
+ * gap. oat never silently guesses; an unresolved tag becomes a COVERAGE_GAP in the report
+ * naming the tag that would close it.
+ */
+import type { Endpoint, OperationObject } from "./types.ts";
+export type EntityAction = "create" | "list" | "read" | "update" | "delete" | "action";
+export interface EntityRef {
+    name: string;
+    action: EntityAction;
+    identity?: string;
+    source: "tag" | "heuristic";
+}
+export interface QueryCapability {
+    filterable: string[];
+    sortable: string[];
+    searchable: string[];
+    selectable: string[];
+    maxLimit?: number;
+    defaultOrder?: string;
+    stableTiebreak?: string;
+    source: "tag" | "heuristic";
+}
+export interface AsyncSpec {
+    poll: string;
+    idFrom?: string;
+    until?: string;
+    successWhen?: string;
+    timeoutMs: number;
+    pollIntervalMs: number;
+}
+export interface EffectSpec {
+    entity: string;
+    op: "create" | "append" | "update" | "delete" | "replace";
+    count?: number;
+}
+export interface Gap {
+    operationId: string;
+    tag: string;
+    detail: string;
+}
+export declare class GapCollector {
+    readonly gaps: Gap[];
+    record(operationId: string, tag: string, detail: string): void;
+}
+export declare function readInvalidate(op: OperationObject): string[];
+export declare function singularise(word: string): string;
+export declare function readEntity(endpoint: Endpoint, gaps?: GapCollector): EntityRef | null;
+export declare function readQueryCapability(endpoint: Endpoint, itemSchema: Record<string, unknown> | null, gaps?: GapCollector): QueryCapability | null;
+export declare function readAsync(op: OperationObject): AsyncSpec | null;
+export declare function readEffects(op: OperationObject): EffectSpec[];
+export interface InviteSpec {
+    invite: string;
+    accept: string;
+    revoke: string;
+    granteeField: string;
+    tokenPointer: string;
+    grantPointer: string;
+}
+export declare function readInvite(op: OperationObject): InviteSpec | null;
+export declare function readSoftDelete(op: OperationObject): string | null;
+export declare function readImmutable(op: OperationObject): string[];
+export declare function readGenerated(op: OperationObject, bodySchema: unknown): string[];
+export declare function readCost(op: OperationObject): "low" | "medium" | "high";
+export declare function readFlag(op: OperationObject, key: string): boolean;
+export declare function readCleanup(op: OperationObject): string | null;
+export declare function readTenantSource(endpoint: Endpoint): "tag" | "heuristic" | null;
+export declare function readTenantParam(endpoint: Endpoint, gaps?: GapCollector): string | null;
+export declare function pathParameterNames(path: string): string[];
+/** Path parameters declared as roots — resources oat cannot create and must be given. */
+export declare function readRootParams(op: OperationObject): string[];
+//# sourceMappingURL=extensions.d.ts.map

package/dist/spec/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/spec/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAA;AAE5E,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEtF,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,KAAK,GAAG,WAAW,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,KAAK,GAAG,WAAW,CAAA;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,GAAG;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,YAAY;IACxB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAK;IACzB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG9D;AASD,wBAAgB,cAAc,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,EAAE,CAI5D;AAiCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAID,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAuBpF;AA4DD,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1C,IAAI,CAAC,EAAE,YAAY,GACjB,eAAe,GAAG,IAAI,CAgDxB;AAoCD,wBAAgB,SAAS,CAAC,EAAE,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAY/D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,eAAe,GAAG,UAAU,EAAE,CAa7D;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,eAAe,GAAG,UAAU,GAAG,IAAI,CAejE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,EAAE,CAE3D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAUhF;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAGvE;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAG9D;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,CAI/E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAatF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,EAAE,CAK5D"}