@ingestron/authoring 0.0.0-stage → 1.0.0

package/dist/explain.js

@@ -0,0 +1,55 @@
+import { contractUses } from "./contract-uses.js";
+import { fieldAt } from "./fields.js";
+import { shown } from "./hover.js";
+/** The described field at the spot, explained; undefined when nothing describes it. */
+export function explainField(project, place, spot, environment, options) {
+    const field = fieldAt(project, place, spot.segments, environment);
+    if (!field)
+        return undefined;
+    const packs = place.kind === "DataContract" ? contractUses(project, field.path.join("."), environment) : [];
+    const inProject = packs.map(({ pack, status, text }) => `- **${pack}**: ${status}. ${text}`);
+    return [fieldText(field, spot, options), inProject.join("\n")].filter(Boolean).join("\n\n");
+}
+/** A method: what it does, which tables use it and what chose it, and its page. */
+export function methodText(info, { docs = (link) => link }) {
+    const used = info.usedBy.length > 0
+        ? `Used by:\n${info.usedBy.map((use) => `- ${use}`).join("\n")}`
+        : "No table uses it in this environment.";
+    return [`**${info.id}**: ${info.description}`, used, `[Reference](${docs(info.docs)})`]
+        .filter(Boolean)
+        .join("\n\n");
+}
+const homes = {
+    platform: "Usually set in the platform.",
+    standard: "Usually set in the standard.",
+    definition: "Usually set in a flow or transform.",
+};
+/** A described field: on its key everything, on its value that value's meaning. */
+function fieldText(field, spot, { docs = (link) => link }) {
+    const chosen = spot.part === "value"
+        ? field.values?.find((item) => String(item.value) === spot.text)
+        : undefined;
+    const body = chosen
+        ? [`\`${spot.text}\`: ${chosen.description ?? ""}`.trim()]
+        : aboutField(field);
+    return [
+        `**${field.name}**: ${field.description ?? ""}`.trim(),
+        ...body,
+        `[Reference](${docs(field.docs)})`,
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+/** Every allowed value with its meaning, the default, an example and where it is usually set. */
+function aboutField(field) {
+    const values = (field.values ?? [])
+        .filter((item) => item.description)
+        .map((item) => `- \`${String(item.value)}\`: ${item.description}`);
+    return [
+        values.join("\n"),
+        field.default !== undefined ? `Default: \`${shown(field.default)}\`.` : undefined,
+        field.example !== undefined ? `For example: \`${shown(field.example)}\`.` : undefined,
+        field.placement && homes[field.placement],
+    ];
+}
+//# sourceMappingURL=explain.js.map

package/dist/explain.js.map

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

package/dist/fields.d.ts

@@ -0,0 +1,19 @@
+import { type Connector, type FieldInfo } from "@ingestron/definitions";
+import type { Place } from "./context.js";
+import { type Project } from "./project.js";
+/** A method's settings at a place: the method and the keys below its settings. */
+export interface SettingsAt {
+    method: string;
+    rest: string[];
+}
+/** The method whose settings `path` is in, if any. */
+export declare function settingsAt(project: Project, place: Place, path: string[], environment: string | undefined): SettingsAt | undefined;
+/** Every setting of a method, from the pack that has it. */
+export declare function methodFields(method: string): FieldInfo[];
+/** The description of the field at `path`, or undefined when nothing describes it. */
+export declare function fieldAt(project: Project, place: Place, path: string[], environment: string | undefined): FieldInfo | undefined;
+/** The connector a Connection document names, from the pack that reads it. */
+export declare function connectorOf(place: Place, project?: Project, environment?: string): Connector | undefined;
+/** The fields directly inside the mapping at `path`. */
+export declare function fieldsIn(project: Project, place: Place, path: string[], environment: string | undefined): FieldInfo[] | undefined;
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnE,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,UAAU,GAAG,SAAS,CAMxB;AAuCD,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAGxD;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,SAAS,GAAG,SAAS,CAQvB;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,GAAG,SAAS,CAqBvB;AAoBD,wDAAwD;AACxD,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,SAAS,EAAE,GAAG,SAAS,CASzB"}

package/dist/fields.js

@@ -0,0 +1,151 @@
+// The description of the field at a place: a document's own field, or a
+// method setting wherever settings are written (the standard's settings and
+// fixed, the platform's settings, a rule's `with`, a flow's or table's `with`).
+import { standardPacks } from "./smart.js";
+import { packs } from "@ingestron/cli";
+import { documentReference, methodReference, referenceKinds, } from "@ingestron/definitions";
+import { parse, stringify } from "yaml";
+import { openProject, resolved } from "./project.js";
+/** The method whose settings `path` is in, if any. */
+export function settingsAt(project, place, path, environment) {
+    return (platformSettings(place, path) ??
+        standardSettings(place, path) ??
+        withSettings(project, place, path, environment));
+}
+/** `settings/<method>/…` in a platform. */
+function platformSettings(place, [first, method, ...rest]) {
+    return place.kind === "Platform" && first === "settings" && method ? { method, rest } : undefined;
+}
+/** `<action>/settings/<method>/…` or `<action>/fixed/<method>/…` in a standard. */
+function standardSettings(place, [action = "", group = "", method, ...rest]) {
+    const standard = place.kind === "Standard" && /^(ingest|transform|store)$/.test(action);
+    return standard && /^(settings|fixed)$/.test(group) && method ? { method, rest } : undefined;
+}
+/** A rule's `with` in a standard, or a flow's, transform's or table's `with`. */
+function withSettings(project, place, path, environment) {
+    const at = path.indexOf("with");
+    if (at < 0)
+        return undefined;
+    const rest = path.slice(at + 1);
+    const [action = "", group, index] = path;
+    const method = place.kind === "Standard" && group === "when"
+        ? place.data[action]?.when?.[Number(index)]?.use
+        : methodOfTable(project, place.file, path.slice(0, at), environment);
+    return method ? { method, rest } : undefined;
+}
+/** Every setting of a method, from the pack that has it. */
+export function methodFields(method) {
+    const pack = packs.find((candidate) => candidate.methods[method]);
+    return pack ? methodReference(pack, method) : [];
+}
+/** The description of the field at `path`, or undefined when nothing describes it. */
+export function fieldAt(project, place, path, environment) {
+    const settings = settingsAt(project, place, path, environment);
+    if (settings)
+        return methodFields(settings.method).find((field) => matches(field.path, settings.rest));
+    return (connectorFields(place, project, environment).find((field) => matches(field.path, path)) ??
+        documentFields(place).find((field) => matches(field.path, path)));
+}
+/** The connector a Connection document names, from the pack that reads it. */
+export function connectorOf(place, project, environment) {
+    if (place.kind !== "Connection")
+        return undefined;
+    const own = project ? standardPacks(project) : packs;
+    const candidates = own.flatMap((pack) => (pack.connectors ?? []).filter((item) => item.id === place.data.connector &&
+        (pack.methods[item.method]?.connectivity ?? [place.data.connectivity]).includes(String(place.data.connectivity))));
+    const method = project
+        ? resolved(project, environment).model?.tables.find((table) => table.ingest?.connection.id === place.data.id)?.ingest?.method
+        : undefined;
+    return (candidates.find((item) => item.method === method) ??
+        (candidates.length === 1 ? candidates[0] : undefined));
+}
+/**
+ * A connection's `settings`, described by its connector: what each means,
+ * and how a flow table's `object` is written for it.
+ */
+function connectorFields(place, project, environment) {
+    const connector = connectorOf(place, project, environment);
+    if (!connector)
+        return [];
+    return connector.settings.map((setting) => ({
+        path: ["settings", setting.name],
+        name: setting.name,
+        description: `${setting.description} For ${connector.title}, a flow table's \`object\` is ${connector.object}.${setting.secret ? " Write it as ${secret:<name>}." : ""}`,
+        type: setting.type ?? "text",
+        required: !setting.optional,
+        ...(setting.values && { values: setting.values.map((value) => ({ value })) }),
+        docs: `/docs/connectors/${connector.id}`,
+    }));
+}
+/** The fields directly inside the mapping at `path`. */
+export function fieldsIn(project, place, path, environment) {
+    const settings = settingsAt(project, place, path, environment);
+    const [all, base] = settings
+        ? [methodFields(settings.method), settings.rest]
+        : [[...connectorFields(place, project, environment), ...documentFields(place)], path];
+    if (!settings && !(place.kind && place.kind in referenceKinds))
+        return undefined;
+    return all.filter((field) => field.path.length === base.length + 1 && matches(field.path.slice(0, -1), base));
+}
+function documentFields(place) {
+    const kind = place.kind;
+    return kind && kind in referenceKinds ? documentReference(kind) : [];
+}
+/** A described path matches when each key is the same or the description says `*`. */
+function matches(described, path) {
+    return (described.length === path.length &&
+        described.every((key, index) => key === "*" || key === path[index]));
+}
+/** The method of the table's step that `path` (up to its `with`) belongs to. */
+function methodOfTable(project, file, path, environment) {
+    const name = path[0] === "tables" ? path[1] : undefined;
+    const action = (name ? path[2] : path[0]);
+    const methodIn = (candidate) => resolved(candidate, environment).model?.tables.find((item) => item.origin.file === file && (!name || item.name === name))?.[action]?.method;
+    // An unfinished setting stops the project resolving. The text as written,
+    // without its `with` settings, still chooses the method; the saved files
+    // are the last resort, as they may say something else.
+    return (methodIn(project) ??
+        methodIn(withoutSettings(project, file)) ??
+        methodIn(openProject(project.folder, new Map())));
+}
+const stripped = new WeakMap();
+/** The project with every `with` in `file` removed, once per project snapshot and file. */
+function withoutSettings(project, file) {
+    let byFile = stripped.get(project);
+    if (!byFile)
+        stripped.set(project, (byFile = new Map()));
+    let found = byFile.get(file);
+    if (!found) {
+        const text = stripWith(project.files.read(file) ?? "");
+        const files = {
+            ...project.files,
+            read: (path) => (path === file ? text : project.files.read(path)),
+        };
+        byFile.set(file, (found = { ...project, files }));
+    }
+    return found;
+}
+/** The document without the `with` of each action, at the top and in each table. */
+function stripWith(text) {
+    let data;
+    try {
+        data = parse(text);
+    }
+    catch {
+        return text;
+    }
+    if (!isObject(data))
+        return text;
+    const tables = isObject(data.tables) ? Object.values(data.tables) : [];
+    for (const owner of [data, ...tables].filter(isObject))
+        for (const action of ["ingest", "transform", "store"]) {
+            const step = owner[action];
+            if (isObject(step))
+                delete step.with;
+        }
+    return stringify(data);
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAgB,MAAM,cAAc,CAAC;AAQnE,sDAAsD;AACtD,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,KAAY,EACZ,IAAc,EACd,WAA+B;IAE/B,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC7B,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC7B,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAS,gBAAgB,CACvB,KAAY,EACZ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAW;IAElC,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC;AAED,mFAAmF;AACnF,SAAS,gBAAgB,CACvB,KAAY,EACZ,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,CAAW;IAEpD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxF,OAAO,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC;AAED,iFAAiF;AACjF,SAAS,YAAY,CACnB,OAAgB,EAChB,KAAY,EACZ,IAAc,EACd,WAA+B;IAE/B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,MAAM,GACV,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,MAAM;QAC3C,CAAC,CAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAwD,EAAE,IAAI,EAAE,CAChF,MAAM,CAAC,KAAK,CAAC,CACd,EAAE,GAAG;QACR,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,OAAO,CACrB,OAAgB,EAChB,KAAY,EACZ,IAAc,EACd,WAA+B;IAE/B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,QAAQ;QACV,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3F,OAAO,CACL,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvF,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CACzB,KAAY,EACZ,OAAiB,EACjB,WAAoB;IAEpB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACtC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS;QAChC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAC7E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAChC,CACJ,CACF,CAAC;IACF,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CACzD,EAAE,MAAM,EAAE,MAAM;QACnB,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;QACjD,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CACtD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAY,EAAE,OAAgB,EAAE,WAAoB;IAC3E,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC3D,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,QAAQ,SAAS,CAAC,KAAK,kCAAkC,SAAS,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,EAAE,EAAE;QACxK,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ;QAC3B,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7E,IAAI,EAAE,oBAAoB,SAAS,CAAC,EAAE,EAAE;KACzC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,QAAQ,CACtB,OAAgB,EAChB,KAAY,EACZ,IAAc,EACd,WAA+B;IAE/B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,QAAQ;QAC1B,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,GAAG,CAAC,MAAM,CACf,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAC3F,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAA+C,CAAC;IACnE,OAAO,IAAI,IAAI,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,sFAAsF;AACtF,SAAS,OAAO,CAAC,SAAmB,EAAE,IAAc;IAClD,OAAO,CACL,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAChC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,aAAa,CACpB,OAAgB,EAChB,IAAY,EACZ,IAAc,EACd,WAA+B;IAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAqC,CAAC;IAC9E,MAAM,QAAQ,GAAG,CAAC,SAAkB,EAAE,EAAE,CACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CACjD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CACrE,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,yEAAyE;IACzE,uDAAuD;IACvD,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC;QACjB,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE9D,2FAA2F;AAC3F,SAAS,eAAe,CAAC,OAAgB,EAAE,IAAY;IACrD,IAAI,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG;YACZ,GAAG,OAAO,CAAC,KAAK;YAChB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC1E,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oFAAoF;AACpF,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QACvC,CAAC;IACH,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/fix-all.d.ts

@@ -0,0 +1,5 @@
+import { type QuickFix } from "./fixes.js";
+import type { Project } from "./project.js";
+/** One fix for every problem with `code` that has a fix, when there are two or more. */
+export declare function fixAll(project: Project, environment: string | undefined, code: string): QuickFix[];
+//# sourceMappingURL=fix-all.d.ts.map

package/dist/fix-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-all.d.ts","sourceRoot":"","sources":["../src/fix-all.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,wFAAwF;AACxF,wBAAgB,MAAM,CACpB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,QAAQ,EAAE,CAgBZ"}

package/dist/fix-all.js

@@ -0,0 +1,23 @@
+// Fix all: every problem of one code fixed by one action, each with its first
+// fix, and an edit that several problems share made once.
+import { problems } from "./diagnostics.js";
+import { positioned } from "./fixes.js";
+/** One fix for every problem with `code` that has a fix, when there are two or more. */
+export function fixAll(project, environment, code) {
+    const fixable = problems(project, environment).filter((problem) => problem.code === code && (problem.fixes?.length ?? 0) > 0);
+    if (fixable.length < 2)
+        return [];
+    const seen = new Set();
+    const edits = fixable
+        .flatMap((problem) => positioned(project, problem.fixes[0]))
+        .filter((edit) => {
+        const key = JSON.stringify(edit);
+        return !seen.has(key) && Boolean(seen.add(key));
+    });
+    // Two different edits of one place would conflict: give none rather than a wrong one.
+    const places = new Set(edits.map((edit) => `${edit.file}:${JSON.stringify(edit.range)}`));
+    if (edits.length === 0 || places.size !== edits.length)
+        return [];
+    return [{ title: `Fix all ${fixable.length} ${code} problems`, edits }];
+}
+//# sourceMappingURL=fix-all.js.map

package/dist/fix-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-all.js","sourceRoot":"","sources":["../src/fix-all.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0DAA0D;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAGvD,wFAAwF;AACxF,MAAM,UAAU,MAAM,CACpB,OAAgB,EAChB,WAA+B,EAC/B,IAAY;IAEZ,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,MAAM,CACnD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CACvE,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,KAAM,CAAC,CAAC,CAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACL,sFAAsF;IACtF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAClE,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,OAAO,CAAC,MAAM,IAAI,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/fixed.d.ts

@@ -0,0 +1,6 @@
+import type { Suggestion } from "./completion.js";
+import type { Place } from "./context.js";
+import { type Project } from "./project.js";
+/** `items` with the fixed value first and the others marked, or unchanged when nothing is fixed here. */
+export declare function markFixed(project: Project, place: Place, environment: string | undefined, items: Suggestion[]): Suggestion[];
+//# sourceMappingURL=fixed.d.ts.map

package/dist/fixed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixed.d.ts","sourceRoot":"","sources":["../src/fixed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE7D,yGAAyG;AACzG,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,KAAK,EAAE,UAAU,EAAE,GAClB,UAAU,EAAE,CAad"}

package/dist/fixed.js

@@ -0,0 +1,43 @@
+import { settingsAt } from "./fields.js";
+import { loadedDocuments } from "./project.js";
+/** `items` with the fixed value first and the others marked, or unchanged when nothing is fixed here. */
+export function markFixed(project, place, environment, items) {
+    const fixed = fixedValue(project, place, environment);
+    if (fixed === undefined)
+        return items;
+    const text = String(fixed);
+    const marked = items.map((item) => item.label === text
+        ? { ...item, detail: "fixed by the standard", preselect: true }
+        : { ...item, detail: `not allowed: the standard fixes this to ${text}` });
+    return [
+        ...marked.filter((item) => item.label === text),
+        ...marked.filter((item) => item.label !== text),
+    ];
+}
+/** The value the standard's `fixed` gives the setting at `place` in a definition's `with`. */
+function fixedValue(project, place, environment) {
+    if (place.kind === "Standard" || place.kind === "Platform")
+        return undefined;
+    const settings = settingsAt(project, place, place.path, environment);
+    const action = place.path[place.path.indexOf("with") - 1];
+    if (!settings || !action)
+        return undefined;
+    const value = keyPath(standardFixed(project, environment, action)?.[settings.method], settings.rest);
+    return typeof value === "object" ? undefined : value;
+}
+/** The standard's `<action>.fixed`, as resolved for the environment, so `${values.…}` is the value that applies. */
+function standardFixed(project, environment, action) {
+    const standard = loadedDocuments(project, environment)?.find((document) => document.kind === "Standard")?.value;
+    return standard?.[action]?.fixed;
+}
+/** The value at `keys` inside `value`, or undefined when a step is missing. */
+function keyPath(value, keys) {
+    let found = value;
+    for (const key of keys) {
+        if (typeof found !== "object" || found === null)
+            return undefined;
+        found = found[key];
+    }
+    return found;
+}
+//# sourceMappingURL=fixed.js.map

package/dist/fixed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixed.js","sourceRoot":"","sources":["../src/fixed.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAgB,MAAM,cAAc,CAAC;AAE7D,yGAAyG;AACzG,MAAM,UAAU,SAAS,CACvB,OAAgB,EAChB,KAAY,EACZ,WAA+B,EAC/B,KAAmB;IAEnB,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,CAAC,KAAK,KAAK,IAAI;QACjB,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,IAAI,EAAE;QAC/D,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,2CAA2C,IAAI,EAAE,EAAE,CAC3E,CAAC;IACF,OAAO;QACL,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;QAC/C,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,SAAS,UAAU,CAAC,OAAgB,EAAE,KAAY,EAAE,WAA+B;IACjF,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CACnB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC9D,QAAQ,CAAC,IAAI,CACd,CAAC;IACF,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED,oHAAoH;AACpH,SAAS,aAAa,CACpB,OAAgB,EAChB,WAA+B,EAC/B,MAAc;IAEd,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,CAC1D,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CAC3C,EAAE,KAAoF,CAAC;IACxF,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;AACnC,CAAC;AAED,+EAA+E;AAC/E,SAAS,OAAO,CAAC,KAAc,EAAE,IAAc;IAC7C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAClE,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/fixes.d.ts

@@ -0,0 +1,33 @@
+import { type Fix } from "@ingestron/config";
+import type { Project } from "./project.js";
+import { type Position } from "./yaml.js";
+/** One quick fix: its title, the problem it solves, and edits that may span files. */
+export interface QuickFix {
+    title: string;
+    /** The problem it solves; absent for a refactoring, such as moving a setting. */
+    problem?: {
+        code: string;
+        line: number;
+    };
+    edits: {
+        file: string;
+        range: {
+            start: Position;
+            end: Position;
+        };
+        text: string;
+    }[];
+    /** A new file to write, for a link to a document that does not exist yet. */
+    create?: {
+        file: string;
+        text: string;
+    };
+}
+/** The fixes for the problems in `file` whose lines meet `at`. */
+export declare function quickFixes(project: Project, environment: string | undefined, file: string, at: {
+    start: Position;
+    end: Position;
+}): QuickFix[];
+/** A fix's text edits, at line and character positions. */
+export declare function positioned(project: Project, fix: Fix): QuickFix["edits"];
+//# sourceMappingURL=fixes.d.ts.map

package/dist/fixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../src/fixes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhE,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,KAAK,EAAE,QAAQ,CAAC;YAAC,GAAG,EAAE,QAAQ,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnF,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GACrC,QAAQ,EAAE,CAcZ;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAUxE"}

package/dist/fixes.js

@@ -0,0 +1,99 @@
+// Quick fixes: the fixes the definitions give for the problems at a place,
+// as text edits with line and character positions.
+import { fixEdits } from "@ingestron/config";
+import { parse } from "yaml";
+import { problems } from "./diagnostics.js";
+import { plainText, skeletons } from "./skeletons.js";
+import { occurrences } from "./navigation.js";
+import { offsetAt, positionAt } from "./yaml.js";
+/** The fixes for the problems in `file` whose lines meet `at`. */
+export function quickFixes(project, environment, file, at) {
+    const here = problems(project, environment)
+        .filter((problem) => problem.file === file)
+        .filter(({ range }) => range.start.line <= at.end.line && range.end.line >= at.start.line);
+    const edited = here
+        .flatMap((problem) => (problem.fixes ?? []).map((fix) => ({
+        title: fix.title,
+        problem: { code: problem.code, line: problem.range.start.line },
+        edits: positioned(project, fix),
+    })))
+        .filter((fix) => fix.edits.length > 0);
+    return [...edited, ...here.flatMap((problem) => createFixes(project, problem))];
+}
+/** A fix's text edits, at line and character positions. */
+export function positioned(project, fix) {
+    const read = (path) => project.files.read(path);
+    return fixEdits(fix, read).map(({ file, start, end, text }) => {
+        const source = read(file) ?? "";
+        return {
+            file,
+            range: { start: positionAt(source, start), end: positionAt(source, end) },
+            text,
+        };
+    });
+}
+/** Folders for the kinds a link can name, where a new document is written. */
+const folders = { DataContract: "contracts", Connection: "connections" };
+/** For a link to a contract or connection that does not exist: create it from its skeleton. */
+function createFixes(project, problem) {
+    if (problem.code === "NO_STANDARD")
+        return createStandard(project, problem);
+    const { kind, id } = (problem.code === "BROKEN_LINK" && linkAt(project, problem)) || {};
+    const folder = kind && folders[kind];
+    if (!id || !folder)
+        return [];
+    const file = newFileFor(project, folder, id);
+    const [skeleton] = skeletons(project, file, id);
+    if (!skeleton?.snippet)
+        return [];
+    return [
+        {
+            title: `Create ${kind} "${id}"`,
+            problem: { code: problem.code, line: problem.range.start.line },
+            edits: [],
+            create: { file, text: plainText(skeleton.snippet) },
+        },
+    ];
+}
+/** `<folder>/<last part of the id>.yaml`, or the whole id when that file exists. */
+function newFileFor(project, folder, id) {
+    const short = `${folder}/${id.split(".").at(-1)}.yaml`;
+    return project.files.read(short) === undefined ? short : `${folder}/${id}.yaml`;
+}
+/** The kind and id of the link written where the problem is. */
+function linkAt(project, problem) {
+    const offset = offsetAt(project.files.read(problem.file) ?? "", problem.range.start);
+    const link = occurrences(project).find(({ file, range, definition, symbol }) => file === problem.file &&
+        !definition &&
+        symbol.startsWith("doc:") &&
+        range[0] <= offset &&
+        offset <= range[1]);
+    const [, kind, id] = /^doc:(\w+):(.+)$/.exec(link?.symbol ?? "") ?? [];
+    return kind && id ? { kind, id } : undefined;
+}
+/** standard.yaml from its skeleton, and added to the imports when they do not load it. */
+function createStandard(project, problem) {
+    const file = "standard.yaml";
+    const [skeleton] = skeletons(project, file);
+    if (!skeleton?.snippet || project.files.read(file) !== undefined)
+        return [];
+    let imports;
+    try {
+        imports = parse(project.files.read("project.yaml") ?? "")?.imports;
+    }
+    catch {
+        return [];
+    }
+    const loaded = Array.isArray(imports) &&
+        imports.some((item) => /^(standard|\*+(\/\*)?)\.yaml$/.test(String(item)));
+    const add = { title: "", edits: [{ file: "project.yaml", pointer: "/imports/-", set: file }] };
+    return [
+        {
+            title: `Create "${file}"`,
+            problem: { code: problem.code, line: problem.range.start.line },
+            edits: loaded ? [] : positioned(project, add),
+            create: { file, text: plainText(skeleton.snippet) },
+        },
+    ];
+}
+//# sourceMappingURL=fixes.js.map

package/dist/fixes.js.map

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

package/dist/flow.d.ts

@@ -0,0 +1,16 @@
+/** Keys inside the line's flow collections, and what is typed at the end. */
+export interface FlowPlace {
+    keys: string[];
+    part: "key" | "value" | "item";
+    /** A value typed straight after `key:`, with no space yet. */
+    tight: boolean;
+}
+/** What starts a line before its flow collection: a list dash, a key, both or neither. */
+export declare function lineStart(line: string): {
+    item: boolean;
+    key?: string;
+    rest: string;
+} | undefined;
+/** The place at the end of `rest`, which starts with `{` or `[`; undefined once they close. */
+export declare function flowPlace(rest: string): FlowPlace | undefined;
+//# sourceMappingURL=flow.d.ts.map

package/dist/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;CAChB;AAUD,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIjG;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAI7D"}

package/dist/flow.js

@@ -0,0 +1,62 @@
+// The place inside `{ }` and `[ ]` written on one line, such as
+// `- { metric: nullValues, mustBe: 0, | }`: which keys lead there, and
+// whether a key, a value or a list item is being typed.
+/** What starts a line before its flow collection: a list dash, a key, both or neither. */
+export function lineStart(line) {
+    const start = /^(\s*)(-\s+)?(?:([\w.-]+):\s*)?(?=[{[])/.exec(line);
+    if (!start)
+        return undefined;
+    return { item: start[2] !== undefined, key: start[3], rest: line.slice(start[0].length) };
+}
+/** The place at the end of `rest`, which starts with `{` or `[`; undefined once they close. */
+export function flowPlace(rest) {
+    const scan = { frames: [], token: "", quote: "" };
+    for (const ch of rest)
+        step(scan, ch);
+    return scan.frames.length > 0 ? placeIn(scan.frames, scan.pending, rest) : undefined;
+}
+/** Reads one character: quotes, opening and closing brackets, keys and commas. */
+function step(scan, ch) {
+    if (inQuote(scan, ch))
+        return;
+    if (ch === ":" && scan.frames.at(-1)?.open === "{")
+        return startValue(scan);
+    if ("{[}],".includes(ch))
+        return structure(scan, ch);
+    scan.token += ch;
+}
+/** Quoted text is skipped, so a comma or bracket inside quotes counts for nothing. */
+function inQuote(scan, ch) {
+    if (!scan.quote && ch !== '"' && ch !== "'")
+        return false;
+    scan.quote = scan.quote === ch ? "" : scan.quote || ch;
+    return true;
+}
+function startValue(scan) {
+    scan.pending = scan.token.trim();
+    scan.token = "";
+}
+function structure(scan, ch) {
+    const top = scan.frames.at(-1);
+    if (ch === "{" || ch === "[")
+        scan.frames.push({ open: ch, key: scan.pending, count: 0 });
+    else if (ch !== ",")
+        scan.frames.pop();
+    else if (top)
+        top.count += 1;
+    scan.pending = undefined;
+    scan.token = "";
+}
+function placeIn(frames, pending, rest) {
+    const keys = frames.flatMap((frame, index) => [
+        ...(frame.key ? [frame.key] : []),
+        ...(frame.open === "[" && index < frames.length - 1 ? [String(frame.count)] : []),
+    ]);
+    const top = frames.at(-1);
+    if (top.open === "[")
+        return { keys, part: "item", tight: false };
+    if (pending !== undefined)
+        return { keys: [...keys, pending], part: "value", tight: /:\S*$/.test(rest) };
+    return { keys, part: "key", tight: false };
+}
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

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

package/dist/hover.d.ts

@@ -0,0 +1,7 @@
+import { type HoverOptions } from "./explain.js";
+import { type Project } from "./project.js";
+/** Markdown for the hover at `offset` in `text`, the open text of `file`, or undefined. */
+export declare function hoverAt(project: Project, file: string, text: string, offset: number, environment: string | undefined, options?: HoverOptions): string | undefined;
+/** A value as definitions write it: YAML flow style. */
+export declare function shown(value: unknown): string;
+//# sourceMappingURL=hover.d.ts.map

package/dist/hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../src/hover.ts"],"names":[],"mappings":"AAOA,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAMtD,2FAA2F;AAC3F,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,YAAiB,GACzB,MAAM,GAAG,SAAS,CAKpB;AAyKD,wDAAwD;AACxD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ5C"}