@opengroundplan/core 0.1.1

package/dist/merge.js

@@ -0,0 +1,412 @@
+/**
+ * Folding a layer's fragment into a manifest the base owns.
+ *
+ * Every merger here is **surgical**: it locates an anchor in the existing text and inserts,
+ * rather than parsing to a model and re-serialising. That is deliberate. A merger that
+ * round-trips through a parser reformats the file and drops comments, and a generated
+ * `pyproject.toml` that lost its comments is worse than a `postApply` line.
+ *
+ * The trade is that each merger only understands one shape. When the anchor is missing it
+ * throws with the file and the expected shape named, because a silent no-op here means a
+ * generated repo that is missing dependencies and reports success.
+ */
+export class MergeError extends Error {
+    constructor(source, destination, detail) {
+        super(`Cannot merge ${source} into ${destination}: ${detail}`);
+    }
+}
+/* ── JSON ─────────────────────────────────────────────────────────────────── */
+const DEPENDENCY_SECTIONS = ['dependencies', 'devDependencies', 'peerDependencies'];
+/** Keys that reach Object.prototype through assignment. */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Objects merge recursively; arrays concatenate without duplicates; scalars take the layer's. */
+export function deepMerge(base, overlay) {
+    if (Array.isArray(base) && Array.isArray(overlay))
+        return [...new Set([...base, ...overlay])];
+    if (!isPlainObject(base) || !isPlainObject(overlay))
+        return overlay;
+    const result = { ...base };
+    for (const [key, value] of Object.entries(overlay)) {
+        if (FORBIDDEN_KEYS.has(key))
+            continue;
+        // defineProperty rather than assignment: assignment invokes inherited setters.
+        Object.defineProperty(result, key, {
+            value: key in base ? deepMerge(base[key], value) : value,
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
+    }
+    return result;
+}
+/**
+ * A layer silently re-pinning a package the base already chose is how a template ships an
+ * ESLint major the base's plugin ecosystem cannot load. Surfaced, never silent.
+ */
+function jsonVersionConflicts(base, overlay) {
+    if (!isPlainObject(base) || !isPlainObject(overlay))
+        return [];
+    const conflicts = [];
+    for (const section of DEPENDENCY_SECTIONS) {
+        const existing = base[section];
+        const incoming = overlay[section];
+        if (!isPlainObject(existing) || !isPlainObject(incoming))
+            continue;
+        for (const [name, version] of Object.entries(incoming)) {
+            const was = existing[name];
+            if (was !== undefined && was !== version) {
+                conflicts.push(`${section}.${name}: ${String(was)} -> ${String(version)}`);
+            }
+        }
+    }
+    return conflicts;
+}
+function mergeJson(existing, fragment, context) {
+    let base;
+    let overlay;
+    try {
+        base = JSON.parse(existing);
+        overlay = JSON.parse(fragment);
+    }
+    catch (error) {
+        throw new MergeError(context.source, context.destination, error.message);
+    }
+    for (const conflict of jsonVersionConflicts(base, overlay))
+        context.onConflict?.(conflict);
+    return JSON.stringify(deepMerge(base, overlay), null, 2) + '\n';
+}
+/* ── TOML (pyproject.toml) ────────────────────────────────────────────────── */
+/** `[table]` heading, or `[[array-of-tables]]`, at the start of a line. */
+const TOML_TABLE = /^\s*\[\[?([^\]]+)\]\]?\s*$/;
+/**
+ * Splits on commas that separate entries, not on commas inside a quoted entry.
+ * A version specifier like `"psycopg[binary]>=3.3,<4"` is one entry containing a comma;
+ * a naive split silently truncates it to `"psycopg[binary`.
+ */
+function splitTomlEntries(inner) {
+    const entries = [];
+    let current = '';
+    let quote = null;
+    for (const char of inner) {
+        if (quote) {
+            current += char;
+            if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            current += char;
+            continue;
+        }
+        if (char === ',') {
+            entries.push(current);
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    entries.push(current);
+    return entries.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+/**
+ * Index of the `]` that closes an array, skipping brackets inside quoted entries.
+ * `"psycopg[binary]>=3.3"` carries a `]` that is part of the value, not the array.
+ */
+function findArrayEnd(text) {
+    let quote = null;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (quote) {
+            if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === '"' || char === "'")
+            quote = char;
+        else if (char === ']')
+            return i;
+    }
+    return -1;
+}
+/** Reads `key = [ "a", "b" ]` arrays out of a fragment, keyed by `table.key`. */
+function readTomlArrays(text) {
+    const arrays = new Map();
+    let table = '';
+    let collecting = null;
+    let buffer = '';
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.replace(/#.*$/, '');
+        if (collecting === null) {
+            const heading = TOML_TABLE.exec(line);
+            if (heading) {
+                table = heading[1].trim();
+                continue;
+            }
+            const start = /^\s*([A-Za-z_][\w-]*)\s*=\s*\[(.*)$/.exec(line);
+            if (!start)
+                continue;
+            collecting = table ? `${table}.${start[1]}` : start[1];
+            buffer = start[2];
+        }
+        else {
+            buffer += '\n' + line;
+        }
+        const close = findArrayEnd(buffer);
+        if (close === -1)
+            continue;
+        arrays.set(collecting, splitTomlEntries(buffer.slice(0, close)));
+        collecting = null;
+        buffer = '';
+    }
+    return arrays;
+}
+/** Inserts entries into an existing array literal, preserving its indentation. */
+function insertIntoTomlArray(text, table, key, entries) {
+    const lines = text.split(/\r?\n/);
+    let current = '';
+    for (let i = 0; i < lines.length; i++) {
+        const heading = TOML_TABLE.exec(lines[i]);
+        if (heading) {
+            current = heading[1].trim();
+            continue;
+        }
+        if (current !== table)
+            continue;
+        const start = new RegExp(`^(\\s*)${key}\\s*=\\s*\\[`).exec(lines[i]);
+        if (!start)
+            continue;
+        // Single-line form: `dev = ["ruff>=0.15"]`
+        const afterOpen = lines[i].slice(lines[i].indexOf('[') + 1);
+        const end = findArrayEnd(afterOpen);
+        if (end !== -1) {
+            const existing = splitTomlEntries(afterOpen.slice(0, end));
+            const merged = [...existing, ...entries.filter((e) => !existing.includes(e))];
+            lines[i] = `${start[1]}${key} = [${merged.join(', ')}]`;
+            return lines.join('\n');
+        }
+        // Multi-line form: find the closing bracket and insert before it.
+        for (let j = i + 1; j < lines.length; j++) {
+            if (!/^\s*\]/.test(lines[j]))
+                continue;
+            const indent = /^(\s*)/.exec(lines[i + 1] ?? '')?.[1] ?? '    ';
+            const existing = lines.slice(i + 1, j).map((l) => l.trim().replace(/,$/, ''));
+            const fresh = entries.filter((e) => !existing.includes(e));
+            lines.splice(j, 0, ...fresh.map((e) => `${indent}${e},`));
+            return lines.join('\n');
+        }
+    }
+    return null;
+}
+/**
+ * Adds a key that the base never declared. A layer should not require every base to
+ * pre-declare every section it might contribute to — `[dependency-groups]` exists in some
+ * Python templates and not others, and that is a reasonable difference between them.
+ */
+function createTomlArray(text, table, key, entries) {
+    const line = `${key} = [${entries.join(', ')}]`;
+    const lines = text.split(/\r?\n/);
+    if (table === '')
+        return `${line}\n${text}`;
+    const heading = lines.findIndex((l) => TOML_TABLE.exec(l)?.[1]?.trim() === table);
+    if (heading === -1) {
+        return `${text.replace(/\n*$/, '')}\n\n[${table}]\n${line}\n`;
+    }
+    // Insert at the end of the existing table, before the next heading.
+    let end = heading + 1;
+    while (end < lines.length && !TOML_TABLE.test(lines[end]))
+        end++;
+    while (end > heading + 1 && lines[end - 1].trim() === '')
+        end--;
+    lines.splice(end, 0, line);
+    return lines.join('\n');
+}
+function mergeToml(existing, fragment, context) {
+    const wanted = readTomlArrays(fragment);
+    if (wanted.size === 0) {
+        throw new MergeError(context.source, context.destination, 'the fragment declares no arrays. Expected e.g. [project] dependencies = ["x>=1"].');
+    }
+    let result = existing;
+    for (const [path, entries] of wanted) {
+        const split = path.lastIndexOf('.');
+        const table = split === -1 ? '' : path.slice(0, split);
+        const key = split === -1 ? path : path.slice(split + 1);
+        result = insertIntoTomlArray(result, table, key, entries) ?? createTomlArray(result, table, key, entries);
+    }
+    return result;
+}
+/* ── .slnx (Visual Studio XML solution) ───────────────────────────────────── */
+/**
+ * A solution's `<Folder Name="/x/">` elements are keyed by name and must not repeat, so
+ * this cannot use the MSBuild merger — appending a second `<Folder Name="/tests/">` produces
+ * a file Visual Studio and MSBuild both reject.
+ *
+ * Matching is on the folder name; children are compared by their normalised text so a merge
+ * run twice is a no-op.
+ */
+const SOLUTION_FOLDER = /<Folder\s+Name="([^"]+)"\s*>([\s\S]*?)<\/Folder>/g;
+/** Child elements of a folder or of the root, one per line, whitespace-normalised. */
+function solutionChildren(inner) {
+    return (inner.match(/<\w+[^>]*\/>/g) ?? []).map((child) => child.replace(/\s+/g, ' ').trim());
+}
+function mergeSolution(existing, fragment, context) {
+    if (!/<\/Solution>/.test(existing)) {
+        throw new MergeError(context.source, context.destination, 'the destination is not a <Solution>.');
+    }
+    const wanted = new Map();
+    for (const match of fragment.matchAll(SOLUTION_FOLDER)) {
+        const name = match[1];
+        wanted.set(name, [...(wanted.get(name) ?? []), ...solutionChildren(match[2])]);
+    }
+    // Children written directly under <Solution>, outside any folder.
+    const rootOnly = fragment.replace(SOLUTION_FOLDER, '');
+    const rootChildren = solutionChildren(/<Solution[^>]*>([\s\S]*)<\/Solution>/.exec(rootOnly)?.[1] ?? '');
+    if (wanted.size === 0 && rootChildren.length === 0) {
+        throw new MergeError(context.source, context.destination, 'the fragment adds nothing. Expected <Folder Name="/tests/"><Project Path="…" /></Folder>.');
+    }
+    let result = existing;
+    for (const [name, children] of wanted) {
+        const present = [...result.matchAll(SOLUTION_FOLDER)].find((m) => m[1] === name);
+        const fresh = children.filter((child) => !result.replace(/\s+/g, ' ').includes(child));
+        if (fresh.length === 0)
+            continue;
+        if (present) {
+            const insertAt = present.index + present[0].lastIndexOf('</Folder>');
+            result = result.slice(0, insertAt) + fresh.map((c) => `  ${c}\n  `).join('') + result.slice(insertAt);
+        }
+        else {
+            const block = `  <Folder Name="${name}">\n${fresh.map((c) => `    ${c}`).join('\n')}\n  </Folder>\n`;
+            result = result.replace(/<\/Solution>/, block + '</Solution>');
+        }
+    }
+    const freshRoot = rootChildren.filter((child) => !result.replace(/\s+/g, ' ').includes(child));
+    if (freshRoot.length) {
+        result = result.replace(/<\/Solution>/, `${freshRoot.map((c) => `  ${c}\n`).join('')}</Solution>`);
+    }
+    return result;
+}
+/* ── XML (.csproj, .props, .targets) ──────────────────────────────────────── */
+/** Top-level children of the fragment's root, with their inner content. */
+function readXmlGroups(text) {
+    const groups = [];
+    const body = /<(?:Project|Solution)\b[^>]*>([\s\S]*)<\/(?:Project|Solution)>/.exec(text);
+    if (!body)
+        return groups;
+    const child = /<(\w+)(?:\s[^>]*)?>([\s\S]*?)<\/\1>/g;
+    for (const match of body[1].matchAll(child)) {
+        groups.push({ tag: match[1], inner: match[2] });
+    }
+    return groups;
+}
+function mergeXml(existing, fragment, context) {
+    const groups = readXmlGroups(fragment);
+    if (groups.length === 0) {
+        throw new MergeError(context.source, context.destination, 'the fragment has no element groups under <Project>.');
+    }
+    const rootClose = /<\/Project>\s*$/.exec(existing);
+    if (!rootClose) {
+        throw new MergeError(context.source, context.destination, 'the destination does not end with </Project>.');
+    }
+    let result = existing;
+    for (const group of groups) {
+        const entries = group.inner
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter((line) => line.startsWith('<'));
+        if (entries.length === 0)
+            continue;
+        // Skip anything already present, so re-running a merge is a no-op.
+        const fresh = entries.filter((entry) => !result.includes(entry));
+        if (fresh.length === 0)
+            continue;
+        const block = `  <${group.tag}>\n${fresh.map((e) => `    ${e}`).join('\n')}\n  </${group.tag}>\n\n`;
+        result = result.slice(0, rootClose.index) + block + result.slice(rootClose.index);
+    }
+    return result;
+}
+/* ── go.mod ───────────────────────────────────────────────────────────────── */
+/**
+ * A go.mod directive line, as opposed to a module path. The trailing `\s` is load-bearing:
+ * without it `^go` also matches `go.opentelemetry.io/otel` and `go.mongodb.org/mongo-driver`,
+ * silently dropping every module in those ecosystems from a fragment that declared them.
+ */
+const GO_DIRECTIVE = /^(?:module|go|toolchain|require|replace|exclude|retract)\s/;
+/** `path version`, the only shape a require entry may take. */
+const GO_REQUIRE_ENTRY = /^(\S+)\s+(v\S+)$/;
+function mergeGoMod(existing, fragment, context) {
+    const candidates = fragment
+        .split(/\r?\n/)
+        .map((line) => line.replace(/^\s*require\s+/, '').trim())
+        .filter((line) => line && !line.startsWith('//'))
+        .filter((line) => !GO_DIRECTIVE.test(line))
+        // A block-form fragment brackets its entries; the brackets are not entries.
+        .filter((line) => line !== '(' && line !== ')');
+    const malformed = candidates.filter((line) => !GO_REQUIRE_ENTRY.test(line));
+    if (malformed.length > 0) {
+        throw new MergeError(context.source, context.destination, `these lines are not require entries: ${malformed.join(', ')}. Expected \`path vX.Y.Z\`.`);
+    }
+    const wanted = candidates;
+    if (wanted.length === 0) {
+        throw new MergeError(context.source, context.destination, 'the fragment declares no require entries. Expected e.g. `require github.com/x/y v1.2.3`.');
+    }
+    // Exact module paths, not a substring scan: `go.opentelemetry.io/otel` occurs inside
+    // `go.opentelemetry.io/otel/trace`, so a substring check reports the parent as already
+    // present whenever a child is, and drops it.
+    const present = new Set(existing
+        .split(/\r?\n/)
+        .map((line) => line.replace(/^\s*require\s+/, '').trim())
+        .map((line) => GO_REQUIRE_ENTRY.exec(line)?.[1])
+        .filter((path) => path !== undefined));
+    const fresh = wanted.filter((entry) => !present.has(entry.split(/\s+/)[0]));
+    if (fresh.length === 0)
+        return existing;
+    const lines = existing.split(/\r?\n/);
+    const blockStart = lines.findIndex((line) => /^require\s*\($/.test(line.trim()));
+    if (blockStart !== -1) {
+        const blockEnd = lines.findIndex((line, i) => i > blockStart && line.trim() === ')');
+        if (blockEnd === -1) {
+            throw new MergeError(context.source, context.destination, 'unterminated require block.');
+        }
+        lines.splice(blockEnd, 0, ...fresh.map((entry) => `\t${entry}`));
+        return lines.join('\n');
+    }
+    // Single-line requires: promote them and the new ones into one block.
+    const singles = lines
+        .map((line, i) => ({ line, i }))
+        .filter(({ line }) => /^require\s+\S/.test(line.trim()));
+    const entries = [...singles.map(({ line }) => line.trim().replace(/^require\s+/, '')), ...fresh];
+    const block = ['require (', ...entries.map((e) => `\t${e}`), ')'];
+    if (singles.length === 0)
+        return existing.trimEnd() + '\n\n' + block.join('\n') + '\n';
+    const kept = lines.filter((_, i) => !singles.some((s) => s.i === i));
+    kept.splice(singles[0].i, 0, ...block);
+    return kept.join('\n');
+}
+/* ── dispatch ─────────────────────────────────────────────────────────────── */
+const MERGERS = [
+    { name: 'json', test: (d) => d.endsWith('.json'), merge: mergeJson },
+    { name: 'toml', test: (d) => d.endsWith('.toml'), merge: mergeToml },
+    { name: 'slnx', test: (d) => d.endsWith('.slnx'), merge: mergeSolution },
+    {
+        name: 'msbuild-xml',
+        test: (d) => /\.(csproj|props|targets|fsproj|vbproj)$/.test(d),
+        merge: mergeXml,
+    },
+    { name: 'go.mod', test: (d) => d.endsWith('go.mod'), merge: mergeGoMod },
+];
+/**
+ * Chosen by destination extension rather than declared per rule. An explicitly declared
+ * strategy can disagree with the file it targets; an inferred one cannot.
+ */
+export function mergeContent(existing, fragment, context) {
+    const merger = MERGERS.find((m) => m.test(context.destination.replace(/\\/g, '/')));
+    if (!merger) {
+        throw new MergeError(context.source, context.destination, `no merger for this file type. Supported: ${MERGERS.map((m) => m.name).join(', ')}.`);
+    }
+    return merger.merge(existing, fragment, context);
+}
+export const SUPPORTED_MERGE_TARGETS = MERGERS.map((m) => m.name);
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,MAAc,EAAE,WAAmB,EAAE,MAAc;QAC7D,KAAK,CAAC,gBAAgB,MAAM,SAAS,WAAW,KAAK,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAQD,iFAAiF;AAEjF,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAU,CAAC;AAE7F,2DAA2D;AAC3D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1E,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,OAAgB;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEpE,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,+EAA+E;QAC/E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;YACjC,KAAK,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YACxD,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAa,EAAE,OAAgB;IAC3D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;YAAE,SAAS;QAEnE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBACzC,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IAC1E,IAAI,IAAa,CAAC;IAClB,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAClE,CAAC;AAED,iFAAiF;AAEjF,2EAA2E;AAC3E,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEhD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,IAAI,CAAC;YAChB,IAAI,IAAI,KAAK,KAAK;gBAAE,KAAK,GAAG,IAAI,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,IAAI,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,KAAK,KAAK;gBAAE,KAAK,GAAG,IAAI,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,GAAG,IAAI,CAAC;aAC1C,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,iFAAiF;AACjF,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAErC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,IAAI,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAE3B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACjE,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,SAAS,mBAAmB,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,OAAiB;IACtF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK;YAAE,SAAS;QAEhC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,2CAA2C;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACxD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,kEAAkE;QAClE,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;YACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,OAAiB;IAClF,MAAM,IAAI,GAAG,GAAG,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;IAE5C,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC;IAClF,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,IAAI,IAAI,CAAC;IAChE,CAAC;IAED,oEAAoE;IACpE,IAAI,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC;IACtB,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAE,GAAG,EAAE,CAAC;IACjE,OAAO,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,CAAC;IAEhE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IAC1E,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAExD,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,mDAAmD,CAAC;AAE5E,sFAAsF;AACtF,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IAC9E,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,kEAAkE;IAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,gBAAgB,CACnC,sCAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CACjE,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACvF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACtE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxG,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,mBAAmB,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;YACrG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF,2EAA2E;AAC3E,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,gEAAgE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzF,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAEzB,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IACzE,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK;aACxB,KAAK,CAAC,OAAO,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,mEAAmE;QACnE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC;QACpG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,YAAY,GAAG,4DAA4D,CAAC;AAElF,+DAA+D;AAC/D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C,SAAS,UAAU,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IAC3E,MAAM,UAAU,GAAG,QAAQ;SACxB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACxD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,4EAA4E;SAC3E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,wCAAwC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC;IAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,uFAAuF;IACvF,6CAA6C;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,QAAQ;SACL,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC/C,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CACxD,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAExC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEjF,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC;QACrF,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,sEAAsE;IACtE,MAAM,OAAO,GAAG,KAAK;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SAC/B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAElE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,iFAAiF;AAEjF,MAAM,OAAO,GAAwF;IACnG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;IACpE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;IACpE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE;IACxE;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,KAAK,EAAE,QAAQ;KAChB;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;CACzE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB,EAAE,OAAqB;IACpF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,UAAU,CAClB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,WAAW,EACnB,4CAA4C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/plan.d.ts

@@ -0,0 +1,12 @@
+import type { GroundplanConfig } from './config.js';
+import type { Blueprint, Plan } from './schema.js';
+import type { Vars } from './tokens.js';
+export interface PlanRequest {
+    solution: string;
+    target: string;
+    blueprints: Blueprint[];
+    adapters: string[];
+    architecture?: string;
+    vars: Vars;
+}
+export declare function buildPlan(request: PlanRequest, config: GroundplanConfig): Promise<Plan>;

package/dist/plan.js

@@ -0,0 +1,206 @@
+/**
+ * Plan phase. Computes the complete file list without writing anything, so the user
+ * reviews exactly what lands where before approving. `groundplan plan` is always safe.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { glob } from 'glob';
+import { test } from './condition.js';
+import { collectAttributions, renderNotice } from './license.js';
+import { collectTokens, renderPath, unresolvedPathTokens, UnknownTokenError } from './tokens.js';
+export async function buildPlan(request, config) {
+    const warnings = [];
+    const files = [];
+    /** Later blueprints intentionally layer over earlier ones; track who wrote what. */
+    const claimed = new Map();
+    for (const blueprint of request.blueprints) {
+        const root = path.join(config.paths.templates, blueprint.kind + 's', blueprint.id);
+        let contributed = 0;
+        for (const rule of blueprint.files) {
+            // A rule gated to another stack is normal; a blueprint where EVERY rule is gated out
+            // contributes nothing at all, and saying so is the difference between "this
+            // architecture does not support your stack" and silence. Counted below.
+            if (!test(rule.when, request.vars))
+                continue;
+            const matches = await glob(rule.from, { cwd: root, nodir: true, dot: true });
+            if (matches.length === 0) {
+                warnings.push(`"${blueprint.id}" rule "${rule.from}" matched no files`);
+                continue;
+            }
+            for (const match of matches) {
+                const source = path.join(root, match);
+                if (isBuildArtifact(match)) {
+                    warnings.push(`"${blueprint.id}" ships build output: ${match} — exclude it from the rule`);
+                    continue;
+                }
+                for (const token of unresolvedPathTokens(match, request.vars)) {
+                    if (LANGUAGE_DUNDERS.has(token))
+                        continue;
+                    warnings.push(`${match}: "__${token}__" left literal — no such variable`);
+                }
+                const relative = restoreDotfile(stripFilesRoot(renderPath(match, request.vars, source), config));
+                const destination = path.normalize(path.join(rule.to, relative));
+                assertInsideTarget(destination, source);
+                const stat = await fs.stat(source);
+                if (stat.size > config.maxFileBytes) {
+                    throw new Error(`${source} exceeds GROUNDPLAN_MAX_FILE_BYTES (${config.maxFileBytes})`);
+                }
+                if (!rule.raw)
+                    await assertTokensResolvable(source, request.vars);
+                const previous = claimed.get(destination);
+                if (previous && rule.onConflict === 'fail') {
+                    throw new Error(`"${blueprint.id}" and "${previous}" both write ${destination}. ` +
+                        `Set onConflict on one of them.`);
+                }
+                if (previous)
+                    warnings.push(`${destination}: "${blueprint.id}" ${rule.onConflict} over "${previous}"`);
+                claimed.set(destination, blueprint.id);
+                contributed++;
+                files.push({
+                    path: destination,
+                    source,
+                    action: previous ? mapAction(rule.onConflict) : 'create',
+                    bytes: stat.size,
+                    fromBlueprint: blueprint.id,
+                });
+            }
+        }
+        if (contributed === 0 && blueprint.files.length > 0) {
+            warnings.push(`"${blueprint.id}" contributed no files — every rule is gated to another stack. ` +
+                `It does not support "${String(request.vars.stack)}"; the choice is still recorded ` +
+                `in AGENTS.md but no layout was created.`);
+        }
+    }
+    if (files.length > config.maxFilesPerPlan) {
+        throw new Error(`Plan has ${files.length} files, over GROUNDPLAN_MAX_FILES (${config.maxFilesPerPlan})`);
+    }
+    const postApply = request.blueprints
+        .flatMap((b) => b.postApply.filter((step) => test(step.when, request.vars)))
+        .map((step) => ({ run: step.run, optional: step.optional }));
+    const notice = renderNotice(collectAttributions(request.blueprints), request.solution);
+    return {
+        solution: request.solution,
+        target: request.target,
+        architecture: request.architecture,
+        blueprints: request.blueprints.map((b) => b.id),
+        adapters: request.adapters,
+        variables: request.vars,
+        files: dedupeKeepLast(files),
+        postApply,
+        warnings,
+        ...(notice ? { notice } : {}),
+    };
+}
+/**
+ * Real file and folder names shaped like `__token__`: Python dunders and the JS
+ * `__tests__` convention. Warning about these on every Python package would bury the
+ * warnings that matter.
+ */
+const LANGUAGE_DUNDERS = new Set([
+    'init', 'main', 'all', 'name', 'future', 'file', 'doc', 'version',
+    'tests', 'mocks', 'snapshots', 'fixtures',
+]);
+/** Directories that are build output, never template content — an agent that ran a build
+ *  locally leaves these behind, and they must not reach a generated repo. */
+const ARTIFACT_DIRS = new Set([
+    'obj', 'bin', 'node_modules', 'dist', 'build', 'target', 'out',
+    '.venv', 'venv', '__pycache__', '.pytest_cache', '.mypy_cache',
+    '.next', '.nuxt', '.turbo', '.vs', '.idea', 'coverage',
+]);
+function isBuildArtifact(relative) {
+    return relative.split(/[\\/]/).some((segment) => ARTIFACT_DIRS.has(segment));
+}
+/**
+ * `files/` is the template root, not part of the output path — a blueprint authored as
+ * `files/AGENTS.md` must land at `AGENTS.md`, with everything below it preserved.
+ */
+function stripFilesRoot(relative, config) {
+    const segments = relative.split(/[\\/]/);
+    return segments[0] === config.blueprintFilesDir ? segments.slice(1).join(path.sep) : relative;
+}
+/**
+ * Names npm refuses to put in a package tarball, mapped back to what the repo needs.
+ *
+ * `.gitignore` and `.npmrc` are stripped from every tarball with no opt-out, and a nested
+ * `.gitignore` is *also* applied as pack-time ignore rules — so a template shipping one loses
+ * both the file and whatever its rules matched (`dist/`, `build/`) from the published package.
+ * Templates therefore store the undotted name and the dot is restored here.
+ *
+ * The same fix create-tauri-app uses; `catalog/sources/mobile-desktop.yaml` records it
+ * shipping `_gitignore` for this reason. `scripts.test.ts` fails if a dotted one reappears.
+ */
+const NPM_STRIPPED_DOTFILES = {
+    gitignore: '.gitignore',
+    npmrc: '.npmrc',
+};
+/** Applied to the basename only — a directory named `gitignore` is not what this is for. */
+function restoreDotfile(relative) {
+    const directory = path.dirname(relative);
+    const restored = NPM_STRIPPED_DOTFILES[path.basename(relative)];
+    if (!restored)
+        return relative;
+    return directory === '.' ? restored : path.join(directory, restored);
+}
+function mapAction(strategy) {
+    if (strategy === 'skip')
+        return 'skip';
+    if (strategy === 'overwrite')
+        return 'overwrite';
+    return 'merge';
+}
+/**
+ * A rendered path must land inside the target, whatever a token value contains.
+ *
+ * Resolution against a sentinel root is the reliable check: `path.isAbsolute` alone is not,
+ * because `path.join('.', 'C:/x')` yields `.\C:\x`, which is neither absolute nor escaping
+ * but is also not a writable path on Windows.
+ */
+const SENTINEL_ROOT = path.resolve(path.sep, 'groundplan-target');
+function assertInsideTarget(destination, source) {
+    const resolved = path.resolve(SENTINEL_ROOT, destination);
+    const relative = path.relative(SENTINEL_ROOT, resolved);
+    if (relative === '' || relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Template ${source} resolves outside the target: ${destination}`);
+    }
+    // A drive letter or UNC prefix cannot be a path segment; it means a token carried one.
+    if (/^[A-Za-z]:$/.test(relative.split(path.sep)[0]) || destination.startsWith('\\\\')) {
+        throw new Error(`Template ${source} produced an unwritable path: ${destination}`);
+    }
+}
+/** Catch a missing variable at plan time — an unresolved token on disk is silent corruption. */
+async function assertTokensResolvable(source, vars) {
+    const content = await fs.readFile(source, 'utf8');
+    for (const token of collectTokens(content)) {
+        if (!(token in vars))
+            throw new UnknownTokenError(token, source);
+    }
+}
+/**
+ * Last writer wins for overwrite, but merges must all survive — a layer adding `pg` and a
+ * layer adding `vitest` both need to reach the base's package.json. Merge entries keep
+ * their composition order; apply folds them in sequence.
+ */
+function dedupeKeepLast(files) {
+    const winner = new Map();
+    const merges = [];
+    for (const file of files) {
+        if (file.action === 'merge') {
+            merges.push(file);
+            continue;
+        }
+        if (file.action === 'skip' && winner.has(file.path))
+            continue;
+        winner.set(file.path, file);
+    }
+    // Base file first, then every merge against it, in the order blueprints were resolved.
+    const ordered = [...winner.values()].sort((a, b) => a.path.localeCompare(b.path));
+    for (const merge of merges) {
+        const at = ordered.findIndex((f) => f.path === merge.path);
+        if (at === -1)
+            ordered.push(merge);
+        else
+            ordered.splice(at + 1, 0, merge);
+    }
+    return ordered;
+}
+//# sourceMappingURL=plan.js.map