@ingestron/authoring 0.0.0-stage → 1.1.0

package/dist/context.d.ts

@@ -0,0 +1,36 @@
+import type { Project } from "./project.js";
+/** The place being edited in one open file. */
+export interface Place {
+    file: string;
+    text: string;
+    /** The document's `kind`, also while the text does not parse. */
+    kind?: string;
+    /** The document as data, as far as it parses. */
+    data: Record<string, unknown>;
+    /** Keys from the root to the value being typed, or to the mapping a new key goes in. */
+    path: string[];
+    part: "key" | "value" | "item";
+    /** A value typed straight after `key:`, with no space yet. */
+    tight: boolean;
+    /** Inside `{ }` or `[ ]`, where only flow-style YAML is valid. */
+    inFlow?: boolean;
+    /** The text before the cursor. */
+    before: string;
+}
+/** The place at `offset` in `text`, the open text of `file`. */
+export declare function placeAt(file: string, text: string, offset: number): Place;
+/** The keys already written in the mapping at the place's path. */
+export declare function writtenKeys(place: Place): Set<string>;
+/** A document's `kind`, also while the text does not parse. */
+export declare function kindOf(text: string, data?: Record<string, unknown>): string | undefined;
+/** A flow's source, and its connection's connector and connectivity. */
+export declare function flowFacts(project: Project, place: Place): {
+    source?: string;
+    connector?: string;
+    connectivity?: string;
+};
+/** The ids of the project's documents of a kind, in file order. */
+export declare function idsOf(project: Project, kind: string): string[];
+/** The parsed document of a kind with an id (or the first one), if it parses. */
+export declare function documentOf(project: Project, kind: string, id?: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,+CAA+C;AAC/C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,wFAAwF;IACxF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAkBzE;AAyBD,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAOrD;AAED,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,0BAAe,GAAG,MAAM,GAAG,SAAS,CAE5E;AAcD,wEAAwE;AACxE,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAMhE;AAED,mEAAmE;AACnE,wBAAgB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9D;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMrC"}

package/dist/context.js

@@ -0,0 +1,98 @@
+// What is at the cursor, worked out once for every feature: the document's
+// kind and data, the keys from the root, whether a key, a value or a list item
+// is being typed, and the facts of a flow's source. It tolerates text that
+// does not parse, because the user is in the middle of typing.
+import { parseDocument } from "yaml";
+import { occurrences } from "./navigation.js";
+import { flowPlace, lineStart } from "./flow.js";
+import { itemIndex, keyPath } from "./yaml.js";
+/** The place at `offset` in `text`, the open text of `file`. */
+export function placeAt(file, text, offset) {
+    const before = text.slice(0, offset);
+    const line = before.slice(before.lastIndexOf("\n") + 1);
+    const data = dataOf(text);
+    // project.yaml has no kind; it is described as the Project kind.
+    const kind = kindOf(text, data) ?? (file === "project.yaml" ? "Project" : undefined);
+    const base = { file, text, data, before, tight: false, ...(kind && { kind }) };
+    const path = keyPath(text, offset);
+    const inFlow = flowAt(text, offset);
+    if (inFlow) {
+        const { outer, ...place } = inFlow;
+        return { ...base, ...place, inFlow: true, path: [...(outer ?? path), ...place.path] };
+    }
+    const value = /^\s*(?:- )?([\w.-]+):\s*\S*$/.exec(line);
+    if (value)
+        return { ...base, part: "value", path: [...path, value[1]], tight: /:\S*$/.test(line) };
+    if (/^\s*-\s*\S*$/.test(line))
+        return { ...base, part: "item", path };
+    return { ...base, part: "key", path };
+}
+/**
+ * Inside `{ }` or `[ ]`: the keys from the line where the collection opens
+ * (this line, or up to 50 lines above it), and what is typed.
+ */
+function flowAt(text, offset) {
+    const lines = text.slice(0, offset).split("\n");
+    const last = lines.length - 1;
+    for (let first = last; first >= Math.max(0, last - 50); first -= 1) {
+        const start = lineStart(lines[first]);
+        const flow = start && flowPlace([start.rest, ...lines.slice(first + 1)].join(" "));
+        if (!start || !flow)
+            continue;
+        const own = [
+            ...(start.item ? [String(itemIndex(lines, first))] : []),
+            ...(start.key ? [start.key] : []),
+        ];
+        // The keys that lead to the line where it opens, from that line's place.
+        const lineOffset = lines.slice(0, first).reduce((sum, line) => sum + line.length + 1, 0);
+        const outer = first === last ? undefined : keyPath(text, lineOffset + lines[first].length);
+        return { part: flow.part, tight: flow.tight, path: [...own, ...flow.keys], outer };
+    }
+    return undefined;
+}
+/** The keys already written in the mapping at the place's path. */
+export function writtenKeys(place) {
+    let node = place.data;
+    for (const key of place.path) {
+        if (!node || typeof node !== "object")
+            return new Set();
+        node = node[key];
+    }
+    return new Set(node && typeof node === "object" && !Array.isArray(node) ? Object.keys(node) : []);
+}
+/** A document's `kind`, also while the text does not parse. */
+export function kindOf(text, data = dataOf(text)) {
+    return typeof data.kind === "string" ? data.kind : /^kind:\s*(\S+)/m.exec(text)?.[1];
+}
+/** The text as data, as far as it parses; empty when nothing does. */
+function dataOf(text) {
+    try {
+        const data = parseDocument(text).toJS();
+        return data && typeof data === "object" && !Array.isArray(data)
+            ? data
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** A flow's source, and its connection's connector and connectivity. */
+export function flowFacts(project, place) {
+    const source = typeof place.data.source === "string" ? place.data.source : undefined;
+    const connection = source ? documentOf(project, "Connection", source) : undefined;
+    const pick = (key) => typeof connection?.[key] === "string" ? { [key]: connection[key] } : {};
+    return { ...(source && { source }), ...pick("connector"), ...pick("connectivity") };
+}
+/** The ids of the project's documents of a kind, in file order. */
+export function idsOf(project, kind) {
+    const prefix = `doc:${kind}:`;
+    const found = occurrences(project).filter((item) => item.definition && item.symbol.startsWith(prefix));
+    return [...new Set(found.map((item) => item.symbol.slice(prefix.length)))];
+}
+/** The parsed document of a kind with an id (or the first one), if it parses. */
+export function documentOf(project, kind, id) {
+    const symbol = `doc:${kind}:${id ?? ""}`;
+    const found = occurrences(project).find((item) => item.definition && (id ? item.symbol === symbol : item.symbol.startsWith(symbol)));
+    return found && dataOf(project.files.read(found.file) ?? "");
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/contract-uses.d.ts

@@ -0,0 +1,8 @@
+import { type Project } from "./project.js";
+/** What each of the project's packs does with a contract field, with the environment's switches. */
+export declare function contractUses(project: Project, path: string, environment: string | undefined): {
+    pack: string;
+    status: string;
+    text: string;
+}[];
+//# sourceMappingURL=contract-uses.d.ts.map

package/dist/contract-uses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-uses.d.ts","sourceRoot":"","sources":["../src/contract-uses.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAUtD,oGAAoG;AACpG,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAelD"}

package/dist/contract-uses.js

@@ -0,0 +1,40 @@
+// What each of the project's packs does with a contract field, in words.
+import { contractUseOf } from "@ingestron/definitions";
+import { resolved } from "./project.js";
+import { standardPacks } from "./smart.js";
+const statuses = {
+    used: "Used",
+    "not-yet": "Not yet",
+    elsewhere: "Elsewhere",
+    documentation: "Documentation only",
+};
+/** What each of the project's packs does with a contract field, with the environment's switches. */
+export function contractUses(project, path, environment) {
+    const manage = resolved(project, environment).model?.platform.manage;
+    return standardPacks(project).flatMap((pack) => {
+        const use = contractUseOf(pack, path);
+        if (!use)
+            return [];
+        if (use.use === "used" && use.needs)
+            return [needing(pack, use, manage?.[use.needs])];
+        const text = use.use === "used"
+            ? use.does
+            : use.use === "documentation"
+                ? "Never changes what is generated."
+                : use.reason;
+        return [{ pack: pack.id, status: statuses[use.use], text }];
+    });
+}
+/** A use that needs a capability: used when the platform turns it on, otherwise how to. */
+function needing(pack, use, on) {
+    if (on)
+        return { pack: pack.id, status: "Used", text: use.does };
+    const capability = pack.capabilities?.find((item) => item.id === use.needs);
+    const needs = capability?.needs.length ? ` It needs: ${capability.needs.join("; ")}.` : "";
+    return {
+        pack: pack.id,
+        status: on === false ? "Off" : "Used when on",
+        text: `${use.does} Turn on \`manage.${use.needs}\` in the platform.${needs}`,
+    };
+}
+//# sourceMappingURL=contract-uses.js.map

package/dist/contract-uses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-uses.js","sourceRoot":"","sources":["../src/contract-uses.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAmC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAgB,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,oBAAoB;CACpC,CAAC;AAEF,oGAAoG;AACpG,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,IAAY,EACZ,WAA+B;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,MACzB,CAAC;IACtC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtF,MAAM,IAAI,GACR,GAAG,CAAC,GAAG,KAAK,MAAM;YAChB,CAAC,CAAC,GAAG,CAAC,IAAI;YACV,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,eAAe;gBAC3B,CAAC,CAAC,kCAAkC;gBACpC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,SAAS,OAAO,CACd,IAAc,EACd,GAA0C,EAC1C,EAAuB;IAEvB,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,MAAM,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc;QAC7C,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,qBAAqB,GAAG,CAAC,KAAK,sBAAsB,KAAK,EAAE;KAC7E,CAAC;AACJ,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,20 @@
+import type { Fix } from "@ingestron/config";
+import { type Project } from "./project.js";
+import type { Position } from "./yaml.js";
+/** One problem in one file of the project. */
+export interface Problem {
+    /** Path relative to the project, with "/". */
+    file: string;
+    range: {
+        start: Position;
+        end: Position;
+    };
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+    /** Changes that each solve it, when the definitions know them. */
+    fixes?: Fix[];
+}
+/** Every problem for the environment, checked once per project snapshot. */
+export declare function problems(project: Project, environment: string | undefined): Problem[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,GAAG,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;CACf;AAMD,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,CAerF"}

package/dist/diagnostics.js

@@ -0,0 +1,143 @@
+// Problems as the CLI finds them, for one environment, at their file and
+// line: loading and resolving with the CLI's packs, template.yaml, and
+// generated files changed by hand.
+import { parseTemplate } from "@ingestron/cli";
+import { kinds } from "@ingestron/definitions";
+import { digestOf } from "@ingestron/generate";
+import { loadedDocuments, resolved } from "./project.js";
+// The editor replaces the project after edits or filesystem events, just as
+// resolution and navigation do. Cursor requests can share the same checks.
+const snapshots = new WeakMap();
+/** Every problem for the environment, checked once per project snapshot. */
+export function problems(project, environment) {
+    let byEnvironment = snapshots.get(project);
+    if (!byEnvironment)
+        snapshots.set(project, (byEnvironment = new Map()));
+    let result = byEnvironment.get(environment);
+    if (!result) {
+        result = [
+            ...definitionProblems(project, environment),
+            ...templateProblems(project),
+            ...editedProblems(project),
+            ...notImportedProblems(project, environment),
+        ];
+        byEnvironment.set(environment, result);
+    }
+    // Callers may edit their diagnostics without changing another feature's view.
+    return structuredClone(result);
+}
+/**
+ * Definition files that project.yaml's imports leave out. They are not part
+ * of the project, so nothing is generated from them and nothing else reports
+ * them; say so, with a fix that imports their folder.
+ */
+function notImportedProblems(project, environment) {
+    const imported = importedFiles(project, environment);
+    if (!imported)
+        return [];
+    const names = new Set(Object.values(kinds).map((kind) => kind.kind));
+    return project.files
+        .list()
+        .filter((path) => /\.ya?ml$/.test(path) && !imported.has(path))
+        .filter((path) => !/(^|\/)build\//.test(path) && !/^(project|template)\.ya?ml$/.test(path))
+        .filter((path) => names.has(kindOf(project.files.read(path) ?? "") ?? ""))
+        .map((path) => {
+        const folder = path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
+        const pattern = folder ? `${folder}/*${path.slice(path.lastIndexOf("."))}` : path;
+        return {
+            ...atStart(path, "warning", "NOT_IMPORTED", "This file is not part of the project: no import in project.yaml matches it, so nothing is generated from it."),
+            fixes: [
+                {
+                    title: `Import "${pattern}" in project.yaml`,
+                    edits: [{ file: "project.yaml", pointer: "/imports/-", set: pattern }],
+                },
+            ],
+        };
+    });
+}
+/** The files the project's imports load; undefined when it does not load. */
+function importedFiles(project, environment) {
+    const documents = loadedDocuments(project, environment);
+    return documents && new Set(documents.map((document) => document.file));
+}
+/** The `kind:` a YAML file declares at its top level, if any. */
+function kindOf(text) {
+    return /^kind:\s*["']?([A-Za-z]+)["']?\s*$/m.exec(text)?.[1];
+}
+function definitionProblems(project, environment) {
+    const { diagnostics } = resolved(project, environment);
+    return diagnostics.map((diagnostic) => {
+        const file = diagnostic.location?.file ?? "project.yaml";
+        const line = (diagnostic.location?.line ?? 1) - 1;
+        const character = (diagnostic.location?.column ?? 1) - 1;
+        const text = project.files.read(file) ?? "";
+        const message = diagnostic.hint
+            ? `${diagnostic.message}\n${diagnostic.hint}`
+            : diagnostic.message;
+        return {
+            file,
+            range: {
+                start: { line, character },
+                end: { line, character: tokenEnd(text, line, character) },
+            },
+            severity: diagnostic.severity,
+            code: diagnostic.code,
+            message,
+            ...(diagnostic.fixes && { fixes: diagnostic.fixes }),
+        };
+    });
+}
+function templateProblems(project) {
+    const text = project.files.read("template.yaml");
+    if (text === undefined)
+        return [];
+    try {
+        parseTemplate(text, "template", project.folder);
+        return [];
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return [atStart("template.yaml", "error", "TEMPLATE", message)];
+    }
+}
+/** Generated files whose text no longer matches the digest their manifest records. */
+function editedProblems(project) {
+    return project.files
+        .list()
+        .filter((path) => path === ".generated.json" || path.endsWith("/.generated.json"))
+        .flatMap((manifest) => {
+        const base = manifest.slice(0, -".generated.json".length);
+        const recorded = manifestFiles(project.files.read(manifest));
+        return Object.entries(recorded).flatMap(([path, digest]) => {
+            const text = project.files.read(`${base}${path}`);
+            if (text === undefined || digestOf(text) === digest)
+                return [];
+            const message = "Changed by hand since it was generated: the next apply reports a conflict. Move the change into the definitions, or delete the file to generate it again.";
+            return [atStart(`${base}${path}`, "warning", "EDITED", message)];
+        });
+    });
+}
+function manifestFiles(text) {
+    try {
+        return JSON.parse(text ?? "{}").files ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function atStart(file, severity, code, message) {
+    return {
+        file,
+        severity,
+        code,
+        message,
+        range: { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } },
+    };
+}
+/** The end of the word at a position, so the squiggle covers the value, not the line. */
+function tokenEnd(text, line, character) {
+    const rest = (text.split("\n")[line] ?? "").slice(character);
+    const word = /^[^\s,}\]]+/.exec(rest)?.[0].length ?? 0;
+    return character + Math.max(word, 1);
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uEAAuE;AACvE,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAgB,MAAM,cAAc,CAAC;AAevE,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,SAAS,GAAG,IAAI,OAAO,EAA+C,CAAC;AAE7E,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,WAA+B;IACxE,IAAI,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,aAAa;QAAE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG;YACP,GAAG,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC;YAC3C,GAAG,gBAAgB,CAAC,OAAO,CAAC;YAC5B,GAAG,cAAc,CAAC,OAAO,CAAC;YAC1B,GAAG,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC;SAC7C,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,8EAA8E;IAC9E,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,OAAgB,EAAE,WAA+B;IAC5E,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,KAAK;SACjB,IAAI,EAAE;SACN,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC9D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1F,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;SACzE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,OAAO;YACL,GAAG,OAAO,CACR,IAAI,EACJ,SAAS,EACT,cAAc,EACd,8GAA8G,CAC/G;YACD,KAAK,EAAE;gBACL;oBACE,KAAK,EAAE,WAAW,OAAO,mBAAmB;oBAC5C,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;iBACvE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CAAC,OAAgB,EAAE,WAA+B;IACtE,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACxD,OAAO,SAAS,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,iEAAiE;AACjE,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB,EAAE,WAA+B;IAC3E,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACvD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,IAAI,cAAc,CAAC;QACzD,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI;YAC7B,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,EAAE;YAC7C,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;QACvB,OAAO;YACL,IAAI;YACJ,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC1B,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;aAC1D;YACD,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO;YACP,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;SACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,cAAc,CAAC,OAAgB;IACtC,OAAO,OAAO,CAAC,KAAK;SACjB,IAAI,EAAE;SACN,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;SACjF,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;YACzD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;YAClD,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM;gBAAE,OAAO,EAAE,CAAC;YAC/D,MAAM,OAAO,GACX,2JAA2J,CAAC;YAC9J,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB;IAC7C,IAAI,CAAC;QACH,OAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAwC,CAAC,KAAK,IAAI,EAAE,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,QAA6B,EAC7B,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;KAC5E,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY,EAAE,SAAiB;IAC7D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACvD,OAAO,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/docs-entries.d.ts

@@ -0,0 +1,5 @@
+import type { Project } from "./project.js";
+import { type ReferenceEntry } from "./reference.js";
+/** The entry for a docs path such as `/docs/reference/packs/adf#adf-copy`, else undefined. */
+export declare function referenceForDocs(project: Project, path: string, environment: string | undefined): ReferenceEntry | undefined;
+//# sourceMappingURL=docs-entries.d.ts.map

package/dist/docs-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-entries.d.ts","sourceRoot":"","sources":["../src/docs-entries.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAU7F,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,cAAc,GAAG,SAAS,CAQ5B"}

package/dist/docs-entries.js

@@ -0,0 +1,109 @@
+// A docs link as a Reference panel entry, for what the code describes: a
+// document kind, a field and the fields under it, a method and its settings,
+// a problem code and a connector. Other pages are left to the site.
+import { packs } from "@ingestron/cli";
+import { codeHelp, documentReference, loadingCodeHelp, methodReference, referenceKinds, } from "@ingestron/definitions";
+import { methodInfo } from "./methods.js";
+import { documentEntry, fieldEntry, methodEntry } from "./reference.js";
+const noSpot = {
+    part: "key",
+    segments: [],
+    pointer: "",
+    text: "",
+    range: [0, 0],
+};
+/** The entry for a docs path such as `/docs/reference/packs/adf#adf-copy`, else undefined. */
+export function referenceForDocs(project, path, environment) {
+    const [page = "", anchor = ""] = path.split("#");
+    if (page === "/docs/reference/documents")
+        return documentsEntry(anchor);
+    if (page === "/docs/reference/errors")
+        return codeEntry(anchor);
+    const pack = /^\/docs\/reference\/packs\/([\w-]+)$/.exec(page)?.[1];
+    if (pack)
+        return packEntry(project, pack, anchor, path, environment);
+    const connector = /^\/docs\/connectors\/([\w-]+)$/.exec(page)?.[1];
+    return connector ? connectorEntry(connector, path) : undefined;
+}
+function documentsEntry(anchor) {
+    const kind = Object.keys(referenceKinds).find((name) => name.toLowerCase() === anchor);
+    if (kind)
+        return documentEntry(kind);
+    for (const name of Object.keys(referenceKinds)) {
+        const fields = documentReference(name);
+        const field = fields.find((item) => item.docs.endsWith(`#${anchor}`));
+        if (field)
+            return withChildren(fieldEntry(field, noSpot, `Field of ${name}`), field, fields);
+    }
+    return undefined;
+}
+function packEntry(project, id, anchor, path, environment) {
+    const pack = packs.find((item) => item.id === id);
+    if (!pack)
+        return undefined;
+    if (pack.methods[anchor]) {
+        const info = methodInfo(project, anchor, environment);
+        return info && methodEntry(info);
+    }
+    for (const method of Object.keys(pack.methods)) {
+        const fields = methodReference(pack, method);
+        const field = fields.find((item) => item.docs === path);
+        if (field)
+            return withChildren(fieldEntry(field, noSpot, `Setting of ${method}`), field, fields);
+    }
+    return undefined;
+}
+/** The fields directly under a field, to go further. */
+function withChildren(entry, field, all) {
+    const depth = field.path.length;
+    const children = all.filter((item) => item.path.length > depth &&
+        item.path.slice(0, depth).join("/") === field.path.join("/") &&
+        item.path.slice(depth).every((key, index, rest) => key === "*" || index === rest.length - 1));
+    return children.length > 0
+        ? {
+            ...entry,
+            fields: children.map((item) => ({
+                name: item.name,
+                docs: item.docs,
+                ...(item.description && { text: item.description }),
+            })),
+        }
+        : entry;
+}
+function codeEntry(code) {
+    const help = codeHelp[code] ??
+        loadingCodeHelp[code];
+    if (!help)
+        return undefined;
+    return {
+        title: code,
+        subtitle: "Problem code",
+        text: help.meaning,
+        facts: [{ label: "Fix", value: help.fix }],
+        docs: `/docs/reference/errors#${code}`,
+    };
+}
+function connectorEntry(id, path) {
+    const found = packs.flatMap((pack) => (pack.connectors ?? [])
+        .filter((item) => item.id === id)
+        .map((connector) => ({ pack, connector })));
+    const [first] = found;
+    if (!first)
+        return undefined;
+    return {
+        title: first.connector.title,
+        subtitle: "Connector",
+        text: found
+            .map(({ pack, connector }) => `${pack.id}, \`${connector.method}\`: ${connector.generates}`)
+            .join(" "),
+        facts: [{ label: "Object", value: first.connector.object }],
+        fields: first.connector.settings.map((setting) => ({
+            name: setting.name,
+            text: `${setting.description}${setting.secret ? " A secret." : ""}`,
+            docs: `${path}#settings`,
+        })),
+        fieldsHeading: "Settings",
+        docs: path,
+    };
+}
+//# sourceMappingURL=docs-entries.js.map

package/dist/docs-entries.js.map

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

package/dist/docs.d.ts

@@ -0,0 +1,7 @@
+/** The errors page entry for a problem code, if the code is documented there. */
+export declare function codeDocs(code: string): string | undefined;
+/** Every documentation link the editor can show, once each. */
+export declare function docsLinks(): string[];
+/** A link on the docs site at `base`, such as https://docs.ingestron.io. */
+export declare function docsUrl(base: string, link: string): string;
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAWA,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAgBpC;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/docs.js

@@ -0,0 +1,23 @@
+// The documentation pages the editor links to: each field and setting, and
+// each problem code. The docs site checks that every one of them exists.
+import { packs } from "@ingestron/cli";
+import { codeHelp, documentReference, loadingCodeHelp, methodReference, referenceKinds, } from "@ingestron/definitions";
+/** The errors page entry for a problem code, if the code is documented there. */
+export function codeDocs(code) {
+    return code in codeHelp || code in loadingCodeHelp ? `/docs/reference/errors#${code}` : undefined;
+}
+/** Every documentation link the editor can show, once each. */
+export function docsLinks() {
+    const fields = [
+        ...Object.keys(referenceKinds).flatMap((kind) => documentReference(kind)),
+        ...packs.flatMap((pack) => Object.keys(pack.methods).flatMap((id) => methodReference(pack, id))),
+    ].map((field) => field.docs);
+    const methods = packs.flatMap((pack) => Object.keys(pack.methods).map((id) => `/docs/reference/packs/${pack.id}#${id}`));
+    const codes = [...Object.keys(codeHelp), ...Object.keys(loadingCodeHelp)].map((code) => `/docs/reference/errors#${code}`);
+    return [...new Set([...fields, ...methods, ...codes])];
+}
+/** A link on the docs site at `base`, such as https://docs.ingestron.io. */
+export function docsUrl(base, link) {
+    return `${base.replace(/\/+$/, "")}${link}`;
+}
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,eAAe,CAAC,CAAC,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG;QACb,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9C,iBAAiB,CAAC,IAAmC,CAAC,CACvD;QACD,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CACrE;KACF,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,yBAAyB,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAChF,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAC3E,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,IAAI,EAAE,CAC3C,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/explain.d.ts

@@ -0,0 +1,14 @@
+import type { Place } from "./context.js";
+import type { MethodInfo } from "./methods.js";
+import type { Project } from "./project.js";
+import type { Spot } from "./yaml.js";
+/** How the editor shows documentation links. */
+export interface HoverOptions {
+    /** A full URL for a docs path such as `/docs/reference/errors#SCHEMA`. */
+    docs?: (link: string) => string;
+}
+/** The described field at the spot, explained; undefined when nothing describes it. */
+export declare function explainField(project: Project, place: Place, spot: Spot, environment: string | undefined, options: HoverOptions): string | undefined;
+/** A method: what it does, which tables use it and what chose it, and its page. */
+export declare function methodText(info: MethodInfo, { docs }: HoverOptions): string;
+//# sourceMappingURL=explain.d.ts.map

package/dist/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../src/explain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAI1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAOpB;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,IAAqB,EAAE,EAAE,YAAY,GAAG,MAAM,CAQ5F"}