@ingestron/authoring 0.0.0-stage → 1.0.0

package/dist/smart.js

@@ -0,0 +1,113 @@
+// Smart defaults: a table for each contract no table uses yet, and the likely
+// choice first for `contract` and `uses`. Each comes from what the project
+// already holds; nothing is invented. Skeletons for new files are in
+// ./skeletons.ts.
+import { packs } from "@ingestron/cli";
+import { documentOf, flowFacts, idsOf } from "./context.js";
+import { occurrences } from "./navigation.js";
+/** The packs the project's standard names, as the CLI provides them. */
+export function standardPacks(project) {
+    const data = documentOf(project, "Standard");
+    const ids = (data?.packs ?? []).map((item) => item.split("@")[0]);
+    return packs.filter((pack) => ids.includes(pack.id));
+}
+/** Contracts that no table or transform names yet. */
+export function unusedContracts(project) {
+    const used = new Set(occurrences(project)
+        .filter((item) => !item.definition && item.symbol.startsWith("doc:DataContract:"))
+        .map((item) => item.symbol.slice("doc:DataContract:".length)));
+    return idsOf(project, "DataContract").filter((id) => !used.has(id));
+}
+/** The object a contract describes: its first schema name, else the end of its id. */
+export function objectOf(project, contract) {
+    const data = documentOf(project, "DataContract", contract);
+    return data?.schema?.[0]?.name ?? contract.split(".").at(-1);
+}
+/** Under a flow's `tables`: one table for each unused contract, the source's first. */
+export function newTables(project, place) {
+    const { source } = flowFacts(project, place);
+    const contracts = unusedContracts(project);
+    const own = contracts.filter((id) => id.startsWith(`${source}.`));
+    return [...own, ...contracts.filter((id) => !own.includes(id))].map((contract) => {
+        const name = objectOf(project, contract);
+        return {
+            label: name,
+            kind: "value",
+            detail: contract,
+            snippet: `${name}: { object: ${name}, contract: ${contract} }`,
+        };
+    });
+}
+/** The suggestion with this label first and preselected. */
+export function preferred(items, label) {
+    const chosen = items.find((item) => item.label === label);
+    if (!chosen)
+        return items;
+    return [{ ...chosen, preselect: true }, ...items.filter((item) => item !== chosen)];
+}
+/** For a flow's ingest: the methods that can read its source first, the others with why not. */
+export function rankMethods(project, place, items, method) {
+    const facts = flowFacts(project, place);
+    if (!facts.connector)
+        return items;
+    const ranked = items.map((item) => ({ item, why: whyNot(method(item.label), facts) }));
+    const can = ranked
+        .filter(({ why }) => !why)
+        .map(({ item }, index) => ({ ...item, preselect: index === 0 }));
+    const cannot = ranked.filter(({ why }) => why).map(({ item, why }) => ({ ...item, detail: why }));
+    return [...can, ...cannot];
+}
+function whyNot(method, { connector, connectivity }) {
+    if (method?.connectors && !method.connectors.includes(connector ?? ""))
+        return `cannot read ${connector} sources`;
+    if (method?.connectivity && connectivity && !method.connectivity.includes(connectivity))
+        return `cannot reach ${connectivity} sources`;
+    return undefined;
+}
+/** Contract quality rules that Ingestron checks on each row, ready to fill in. */
+const rowRules = [
+    ["Not null", "{ metric: nullValues, mustBe: 0 }", "No row may be null."],
+    [
+        "Allowed values",
+        "{ metric: invalidValues, arguments: { validValues: [${1:a}, ${2:b}] }, mustBe: 0 }",
+        "Every row is one of the values, or null.",
+    ],
+    [
+        "Matches a pattern",
+        '{ metric: invalidValues, arguments: { pattern: "${1:[a-z]+}" }, mustBe: 0 }',
+        "Every row matches the regular expression, or is null.",
+    ],
+    [
+        "No missing values",
+        '{ metric: missingValues, arguments: { missingValues: [null, ""] }, mustBe: 0 }',
+        "No row is null or one of the values counted as missing.",
+    ],
+].map(([label, snippet, documentation]) => ({
+    label: label,
+    kind: "value",
+    snippet: snippet,
+    documentation: `${documentation} Checked on each row.`,
+}));
+/** A contract column's quality list, where rules are written. */
+function inColumnQuality(place) {
+    const [schema, , properties, , quality] = place.path;
+    const column = schema === "schema" && properties === "properties" && quality === "quality";
+    return place.kind === "DataContract" && column && place.path.length === 5;
+}
+/** Ready-made items for the list at the place: quality rules under a contract column. */
+export function itemSnippets(place) {
+    return inColumnQuality(place) ? rowRules : [];
+}
+/** The fields that make up a quality rule come before the rule's metadata. */
+const ruleFields = ["metric", "mustBe", "arguments", "type", "unit", "name", "description"];
+/** Fields in the order a person writes them: for a quality rule, what it checks first. */
+export function firstFields(place, fields) {
+    if (!inColumnQuality(place))
+        return fields;
+    const rank = (field) => {
+        const index = ruleFields.indexOf(field.name);
+        return index < 0 ? ruleFields.length : index;
+    };
+    return [...fields].sort((a, b) => rank(a) - rank(b));
+}
+//# sourceMappingURL=smart.js.map

package/dist/smart.js.map

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

package/dist/suggestion.d.ts

@@ -0,0 +1,23 @@
+import type { QuickFix } from "./fixes.js";
+/** One suggestion. */
+export interface Suggestion {
+    label: string;
+    kind: "field" | "value" | "reference" | "method" | "setting" | "document";
+    detail?: string;
+    documentation?: string;
+    /** Text to insert, with tab stops, instead of the label. */
+    snippet?: string;
+    /** The likely choice, selected first. */
+    preselect?: boolean;
+    /** Plain text to insert instead of the label, such as the label after a space. */
+    insertText?: string;
+    /** The documentation page and anchor that explain it. */
+    docs?: string;
+    /** Offered straight after a list's `-`: insert after it rather than replace it. */
+    afterDash?: boolean;
+    /** Ask for suggestions again once inserted, such as the keys on a new line. */
+    retrigger?: boolean;
+    /** Edits to make once inserted, possibly in other files, such as declaring an input. */
+    edits?: QuickFix["edits"];
+}
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.d.ts","sourceRoot":"","sources":["../src/suggestion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,sBAAsB;AACtB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wFAAwF;IACxF,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC3B"}

package/dist/suggestion.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suggestion.js.map

package/dist/suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.js","sourceRoot":"","sources":["../src/suggestion.ts"],"names":[],"mappings":""}

package/dist/symbols.d.ts

@@ -0,0 +1,12 @@
+import type { Project } from "./project.js";
+/** One named thing and where it is defined. */
+export interface ProjectSymbol {
+    name: string;
+    /** `table`, `value`, or the document's kind, such as `Flow`. */
+    kind: string;
+    file: string;
+    range: [number, number];
+}
+/** Every definition in the project, a transform named once (as a transform, not also as its table). */
+export declare function projectSymbols(project: Project): ProjectSymbol[];
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAkBhE"}

package/dist/symbols.js

@@ -0,0 +1,21 @@
+// The project's named things: tables, documents and values, where each is
+// defined, for "Go to Symbol in Workspace" and a file's outline.
+import { occurrences } from "./navigation.js";
+/** Every definition in the project, a transform named once (as a transform, not also as its table). */
+export function projectSymbols(project) {
+    const definitions = occurrences(project).filter((item) => item.definition);
+    const transforms = new Set(definitions
+        .filter((item) => item.symbol.startsWith("doc:Transform:"))
+        .map((item) => `${item.file}:${item.range[0]}`));
+    return definitions
+        .filter((item) => item.symbol.startsWith("doc:") || !transforms.has(`${item.file}:${item.range[0]}`))
+        .flatMap(({ symbol, file, range }) => {
+        const [kind, ...rest] = symbol.split(":");
+        if (kind === "doc")
+            return [{ name: rest.slice(1).join(":"), kind: rest[0], file, range }];
+        if (kind === "table" || kind === "value")
+            return [{ name: rest.join(":"), kind, file, range }];
+        return [];
+    });
+}
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAY9C,uGAAuG;AACvG,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,WAAW;SACR,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;SAC1D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAClD,CAAC;IACF,OAAO,WAAW;SACf,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7F;SACA,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5F,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO;YACtC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/value-help.d.ts

@@ -0,0 +1,7 @@
+import type { FieldInfo } from "@ingestron/definitions";
+import type { Suggestion } from "./completion.js";
+import type { Place } from "./context.js";
+import type { Project } from "./project.js";
+/** The suggestions for `field`'s value at `place`, the likely one first. */
+export declare function valueHelp(project: Project, place: Place, field: FieldInfo): Suggestion[];
+//# sourceMappingURL=value-help.d.ts.map

package/dist/value-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-help.d.ts","sourceRoot":"","sources":["../src/value-help.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE,CAcxF"}

package/dist/value-help.js

@@ -0,0 +1,206 @@
+// Values to suggest for a field without a fixed list of allowed values: its
+// default and example, true or false, the pack's smart defaults for a
+// standard's naming, layers, types and quality, the project's connectors and
+// layers, a connection's settings, and for a mapping or list a block of its
+// fields or a new line that asks for them.
+import { packs } from "@ingestron/cli";
+import { stringify } from "yaml";
+import { standardPacks } from "./smart.js";
+/** The suggestions for `field`'s value at `place`, the likely one first. */
+export function valueHelp(project, place, field) {
+    if (place.part === "item")
+        return itemValues(project, place, field);
+    const own = projectValues(project, place, field);
+    if (own.length > 0)
+        return own;
+    const fallback = field.default ?? packDefault(project, place);
+    if (/mapping|list/.test(field.type))
+        return place.inFlow ? flowValues(field, fallback) : blockValues(field, fallback);
+    if (field.type === "true or false")
+        return booleans(field);
+    return [
+        ...(fallback !== undefined ? [scalar(fallback, "default", field, true)] : []),
+        ...(field.example !== undefined && field.example !== fallback
+            ? [scalar(field.example, "example", field, false)]
+            : []),
+    ];
+}
+/** A standard's or platform's naming, layers, types and quality: the first pack's defaults. */
+function packDefault(project, place) {
+    if (place.path.length !== 1 || !["Standard", "Platform"].includes(place.kind ?? ""))
+        return;
+    const [pack] = standardPacks(project);
+    const defaults = pack?.defaults;
+    return defaults?.[place.path[0]];
+}
+/** A new item of a list of plain values: the packs not yet listed, or the default's items. */
+function itemValues(project, place, field) {
+    const written = new Set(listAt(place).map(String));
+    const choices = place.kind === "Standard" && place.path.join(".") === "packs"
+        ? packIds()
+        : [field.default ?? packDefault(project, place)]
+            .flat()
+            .filter((value) => value != null && isScalar(value))
+            .map(String);
+    return choices
+        .filter((choice) => !written.has(choice))
+        .map((label) => ({ label, kind: "value" }));
+}
+function listAt(place) {
+    const value = place.path.reduce((node, key) => node && typeof node === "object" ? node[key] : undefined, place.data);
+    return Array.isArray(value) ? value : [];
+}
+/** Every pack as `<id>@<version>`, the first pack of a standard first. */
+function packIds() {
+    return packs.map((pack) => `${pack.id}@${pack.version}`);
+}
+/** A standard's packs: each pack alone, then all of them, the first giving the defaults. */
+function packLists() {
+    const ids = packIds();
+    return [...ids.map((id) => [id]), ...(ids.length > 1 ? [ids] : [])].map((list, index) => ({
+        label: `[${list.join(", ")}]`,
+        kind: "value",
+        ...(index === 0 && { preselect: true }),
+    }));
+}
+/** Inside { } or [ ]: the default in flow style, or an empty mapping or list to fill. */
+function flowValues(field, fallback) {
+    const list = field.type.includes("list");
+    const filled = fallback !== undefined &&
+        (typeof fallback !== "object" || Object.keys(fallback ?? {}).length > 0)
+        ? [
+            scalar(fallback, field.default !== undefined ? "default" : "the pack's default", field, true),
+        ]
+        : [];
+    const empty = {
+        label: list ? "[ ]" : "{ }",
+        kind: "value",
+        detail: list ? "a list" : "a mapping",
+        snippet: list ? "[$0]" : "{ $0 }",
+        retrigger: true,
+    };
+    return [...filled, empty];
+}
+/** Values the project itself gives: connector ids, layer names, a connection's settings. */
+function projectValues(project, place, field) {
+    const key = place.path.join(".");
+    if (place.kind === "Connection" && key === "connector")
+        return connectorIds(project);
+    if (place.kind === "Standard" && key === "packs")
+        return packLists();
+    if (place.path.at(-1) === "layer" && !field.values)
+        return layersOf(project, place).map((label) => ({ label, kind: "value" }));
+    if (place.kind === "Connection" && key === "settings")
+        return connectionSettings(place);
+    return [];
+}
+/** Each connector the standard's packs read, once. */
+function connectorIds(project) {
+    const connectors = standardPacks(project).flatMap((pack) => pack.connectors ?? []);
+    const seen = new Set();
+    return connectors
+        .filter((connector) => !seen.has(connector.id) && Boolean(seen.add(connector.id)))
+        .map((connector) => ({
+        label: connector.id,
+        kind: "value",
+        detail: connector.title,
+        documentation: connector.generates,
+        docs: `/docs/connectors/${connector.id}`,
+    }));
+}
+function layersOf(project, place) {
+    const written = place.kind === "Standard" ? place.data.layers : undefined;
+    if (Array.isArray(written))
+        return written.map(String);
+    return standardPacks(project)[0]?.defaults.layers ?? [];
+}
+/** The settings the connection's connector needs, one block per pack that reads it. */
+function connectionSettings(place) {
+    const found = packs.flatMap((pack) => (pack.connectors ?? [])
+        .filter((item) => item.id === place.data.connector)
+        .map((connector) => ({ pack, connector })));
+    if (found.length === 0)
+        return [newLine("settings")];
+    return found.map(({ pack, connector }, at) => {
+        // A secret is written as a reference to its name; any other setting is a tab stop.
+        const required = connector.settings.filter((setting) => !setting.optional);
+        const lines = required.map((setting, index) => setting.secret
+            ? escape(`  ${setting.name}: \${secret:${setting.name}}`)
+            : `  ${escape(setting.name)}: $${index + 1}`);
+        const connectivity = pack.methods[connector.method]?.connectivity?.join(", ");
+        return {
+            label: required.map((setting) => setting.name).join(", "),
+            kind: "value",
+            detail: `${pack.id} ${connector.method}${connectivity ? ` (${connectivity})` : ""}`,
+            documentation: connector.settings
+                .map((item) => `${item.name}: ${item.description}`)
+                .join("\n"),
+            snippet: `\n${lines.join("\n")}`,
+            ...(at === 0 && { preselect: true }),
+        };
+    });
+}
+/** A mapping or list: its default as a block, or a new line that asks for its fields. */
+function blockValues(field, fallback) {
+    const empty = fallback === undefined ||
+        (typeof fallback === "object" && fallback !== null && Object.keys(fallback).length === 0);
+    const list = field.type.includes("list");
+    return [...(empty ? [] : [block(fallback, field)]), newLine(field.name, list)];
+}
+function block(value, field) {
+    const scalars = Array.isArray(value) && value.every(isScalar);
+    const text = scalars
+        ? stringify(value, { flowCollectionPadding: false, collectionStyle: "flow" }).trimEnd()
+        : `\n${stringify(value, { lineWidth: 0 }).trimEnd().replace(/^/gm, "  ")}`;
+    return {
+        label: scalars ? text : summary(value),
+        kind: "value",
+        detail: field.default !== undefined ? "default" : "the pack's default",
+        documentation: field.description ?? "",
+        snippet: escape(text),
+        preselect: true,
+        ...(field.docs && { docs: field.docs }),
+    };
+}
+/** `catalog, schema, table, …` for a mapping. */
+function summary(value) {
+    const keys = Object.keys(value);
+    return keys.length > 4 ? `${keys.slice(0, 4).join(", ")}, …` : keys.join(", ");
+}
+/** A new indented line, with suggestions for what goes there. */
+function newLine(name, item = false) {
+    return {
+        label: item ? `new ${name} item` : `${name} fields`,
+        kind: "value",
+        detail: "on the next line",
+        snippet: item ? "\n  - $0" : "\n  $0",
+        retrigger: true,
+    };
+}
+function booleans(field) {
+    return [true, false].map((value) => ({
+        label: String(value),
+        kind: "value",
+        ...(field.default === value && { detail: "default", preselect: true }),
+    }));
+}
+function scalar(value, why, field, preselect) {
+    const text = isScalar(value)
+        ? stringify(value).trimEnd()
+        : stringify(value, { collectionStyle: "flow" }).trimEnd();
+    return {
+        label: text,
+        kind: "value",
+        detail: why,
+        ...(preselect && { preselect: true }),
+        ...(field.docs && { docs: field.docs }),
+    };
+}
+function isScalar(value) {
+    return value === null || typeof value !== "object";
+}
+/** Text a snippet inserts as it is: `$`, `}` and `\` escaped. */
+function escape(text) {
+    return text.replace(/[$}\\]/g, "\\$&");
+}
+//# sourceMappingURL=value-help.js.map

package/dist/value-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-help.js","sourceRoot":"","sources":["../src/value-help.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sEAAsE;AACtE,6EAA6E;AAC7E,4EAA4E;AAC5E,2CAA2C;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,KAAY,EAAE,KAAgB;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnF,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO;QACL,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ;YAC3D,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,SAAS,WAAW,CAAC,OAAgB,EAAE,KAAY;IACjD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAAE,OAAO;IAC5F,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAA+C,CAAC;IACvE,OAAO,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AACpC,CAAC;AAED,8FAA8F;AAC9F,SAAS,UAAU,CAAC,OAAgB,EAAE,KAAY,EAAE,KAAgB;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GACX,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO;QAC3D,CAAC,CAAC,OAAO,EAAE;QACX,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;aAC3C,IAAI,EAAE;aACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;aACnD,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,MAAM,CAAC,KAAY;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACZ,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EACvF,KAAK,CAAC,IAAI,CACX,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,0EAA0E;AAC1E,SAAS,OAAO;IACd,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,4FAA4F;AAC5F,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxF,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7B,IAAI,EAAE,OAAgB;QACtB,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,yFAAyF;AACzF,SAAS,UAAU,CAAC,KAAgB,EAAE,QAAiB;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GACV,QAAQ,KAAK,SAAS;QACtB,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACtE,CAAC,CAAC;YACE,MAAM,CACJ,QAAQ,EACR,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,EAC9D,KAAK,EACL,IAAI,CACL;SACF;QACH,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QAC3B,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QACrC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACjC,SAAS,EAAE,IAAI;KAChB,CAAC;IACF,OAAO,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,4FAA4F;AAC5F,SAAS,aAAa,CAAC,OAAgB,EAAE,KAAY,EAAE,KAAgB;IACrE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,SAAS,EAAE,CAAC;IACrE,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM;QAChD,OAAO,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC;IACtF,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACxF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,sDAAsD;AACtD,SAAS,YAAY,CAAC,OAAgB;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;SACjF,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnB,KAAK,EAAE,SAAS,CAAC,EAAE;QACnB,IAAI,EAAE,OAAgB;QACtB,MAAM,EAAE,SAAS,CAAC,KAAK;QACvB,aAAa,EAAE,SAAS,CAAC,SAAS;QAClC,IAAI,EAAE,oBAAoB,SAAS,CAAC,EAAE,EAAE;KACzC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,QAAQ,CAAC,OAAgB,EAAE,KAAY;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,KAAK,CAAC,IAAI,CAAC,MAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,uFAAuF;AACvF,SAAS,kBAAkB,CAAC,KAAY;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACnC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAClD,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAC7C,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE;QAC3C,mFAAmF;QACnF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC5C,OAAO,CAAC,MAAM;YACZ,CAAC,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,eAAe,OAAO,CAAC,IAAI,GAAG,CAAC;YACzD,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,CAC/C,CAAC;QACF,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACzD,IAAI,EAAE,OAAgB;YACtB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnF,aAAa,EAAE,SAAS,CAAC,QAAQ;iBAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;iBAClD,IAAI,CAAC,IAAI,CAAC;YACb,OAAO,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChC,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yFAAyF;AACzF,SAAS,WAAW,CAAC,KAAgB,EAAE,QAAiB;IACtD,MAAM,KAAK,GACT,QAAQ,KAAK,SAAS;QACtB,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,KAAK,CAAC,KAAc,EAAE,KAAgB;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,OAAO;QAClB,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACvF,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IAC7E,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACtC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB;QACtE,aAAa,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;QACrB,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,iEAAiE;AACjE,SAAS,OAAO,CAAC,IAAY,EAAE,IAAI,GAAG,KAAK;IACzC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS;QACnD,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;QACrC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAgB;IAChC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;QACpB,IAAI,EAAE,OAAgB;QACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACvE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,GAAW,EAAE,KAAgB,EAAE,SAAkB;IAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC1B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;QAC5B,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5D,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,GAAG;QACX,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACrC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,iEAAiE;AACjE,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/yaml.d.ts

@@ -0,0 +1,33 @@
+/** A key or value at an offset. */
+export interface Spot {
+    /** JSON Pointer of the value (also for a key: the pointer of its value). */
+    pointer: string;
+    segments: string[];
+    part: "key" | "value";
+    /** The scalar's text; empty for a mapping or list. */
+    text: string;
+    range: [number, number];
+}
+/** A zero-based line and character. */
+export interface Position {
+    line: number;
+    character: number;
+}
+/** The deepest key or value at the offset, if any. */
+export declare function spotAt(text: string, offset: number): Spot | undefined;
+/** The range of the value (or key) at a pointer. */
+export declare function rangeOf(text: string, pointer: string, part?: Spot["part"]): [number, number] | undefined;
+/**
+ * The keys of the mapping a key typed at this offset belongs to, from the
+ * indentation of the lines above; works on text that does not parse yet.
+ */
+export declare function keyPath(text: string, offset: number): string[];
+/** Which item of its list the dash on line `at` starts: the dashes above it at the same indentation. */
+export declare function itemIndex(lines: string[], at: number): number;
+/** The line and character of an offset. */
+export declare function positionAt(text: string, offset: number): Position;
+/** The offset of a line and character. */
+export declare function offsetAt(text: string, position: Position): number;
+/** Every key and scalar value in the text, with pointers and ranges. */
+export declare function allSpots(text: string): Spot[];
+//# sourceMappingURL=yaml.d.ts.map

package/dist/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../src/yaml.ts"],"names":[],"mappings":"AAKA,mCAAmC;AACnC,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAGrE;AAiDD,oDAAoD;AACpD,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,IAAI,CAAC,MAAM,CAAW,GAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAU9B;AAiBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAa9D;AAED,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAY7D;AA8BD,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAGjE;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIjE;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAK7C"}