d365fo-mcp 1.0.0

package/dist/utils/formControlExpander.js

@@ -0,0 +1,207 @@
+/**
+ * Deterministic form control expander.
+ *
+ * Walks the curated form-pattern catalog (the SAME data the validator enforces)
+ * and emits the required control skeleton directly, instead of cloning a
+ * reference form or hand-writing per-pattern XML. Because generation and
+ * validation share one source of truth, the output is structurally
+ * pattern-correct by construction — every `required`/`oneOrMore` container the
+ * pattern mandates is present, in spec order, with the pattern's expected
+ * container properties.
+ *
+ * Scope & safety:
+ *   - Covers patterns that have no hand-written `FormPatternTemplates` entry
+ *     (which would otherwise silently degrade to SimpleList).
+ *   - `requiresSubPattern` containers are emitted WITHOUT a declared sub-pattern
+ *     (an FP006 warning, never an error), keeping the output guaranteed
+ *     error-free. Sub-pattern enrichment can be layered on later.
+ *   - The caller (generateSmartForm) self-tests the result against
+ *     validateFormPatternXml and falls back to the proven templates on error.
+ *
+ * Indentation is intentionally simple: both the pattern validator (xml2js) and
+ * the on-write normalizer (normalizeD365Xml) are whitespace-insensitive, so
+ * exact AOT tabbing is applied at write time, not here.
+ */
+import { FormPatternTemplates } from './formPatternTemplates.js';
+/** Normalized control type → AxForm i:type attribute. */
+function iTypeFor(controlType) {
+    return `AxForm${controlType}Control`;
+}
+/** A node is concrete (emittable) when it names a single, specific control type. */
+export function isConcrete(spec) {
+    const t = spec.controlTypes[0];
+    return spec.controlTypes.length >= 1 && t !== '*' && !!t;
+}
+/** Required containers only — optional/zeroOrMore slots are left out of the skeleton. */
+export function isRequired(spec) {
+    return spec.occurrence === 'required' || spec.occurrence === 'oneOrMore';
+}
+/**
+ * Whether the expander can faithfully build this pattern. It bails when:
+ *   - the pattern has no known versions (e.g. the "Custom" escape-hatch pattern),
+ *   - any *required* node (at any depth) names no concrete control type (a `*`
+ *     wildcard slot — e.g. HubPart's required "Chart"), which the expander cannot
+ *     materialise and which would trip FP003.
+ *   - sibling slots share a control type (e.g. two `Group`s distinguished only
+ *     by Style). Skipping an optional one shifts the validator's type-based
+ *     greedy matcher onto the wrong slot, so the result is unreliable.
+ * Callers should fall back to a hand-written template / clone for these.
+ */
+export function canExpandPattern(spec) {
+    if (spec.versions.length === 0)
+        return false;
+    const requiredNodesConcrete = (nodes) => nodes
+        .filter(isRequired)
+        .every((n) => isConcrete(n) && requiredNodesConcrete(n.children ?? []));
+    // No two sibling specs may share a concrete control type — the validator
+    // matches children by type, so duplicates become ambiguous once optionals are
+    // dropped. Check every level we emit / the validator descends into.
+    const levelUnambiguous = (nodes) => {
+        const seen = new Set();
+        for (const n of nodes.filter(isConcrete)) {
+            const t = n.controlTypes[0];
+            if (seen.has(t))
+                return false;
+            seen.add(t);
+        }
+        return nodes.filter(isRequired).every((n) => levelUnambiguous(n.children ?? []));
+    };
+    return requiredNodesConcrete(spec.root) && levelUnambiguous(spec.root);
+}
+/** Serialize a property map into indented <Prop>value</Prop> lines. */
+function emitProperties(props, indent) {
+    if (!props)
+        return '';
+    return Object.entries(props)
+        .map(([k, v]) => `${indent}<${k}>${v}</${k}>`)
+        .join('\n');
+}
+/**
+ * Public wrapper around {@link emitNode}: render a single pattern NodeSpec (and
+ * its required descendants) as AxForm control XML at the given indent depth.
+ * Used by the form-repair path to materialise a missing required control.
+ * Returns '' for nodes that cannot be concretely emitted.
+ */
+export function buildControlXml(spec, opt, depth) {
+    return emitNode(spec, opt, depth);
+}
+/**
+ * Emit one control node and its required descendants. Returns '' for nodes that
+ * cannot be concretely emitted (wildcard slots). `gridFields` are rendered as
+ * column controls when the node is a Grid bound to the primary datasource.
+ */
+function emitNode(spec, opt, depth) {
+    if (!isConcrete(spec))
+        return '';
+    const indent = '\t'.repeat(depth);
+    const controlType = spec.controlTypes[0];
+    const name = spec.nameHint || spec.id;
+    const lines = [];
+    lines.push(`${indent}<AxFormControl xmlns="" i:type="${iTypeFor(controlType)}">`);
+    lines.push(`${indent}\t<Name>${name}</Name>`);
+    lines.push(`${indent}\t<Type>${controlType}</Type>`);
+    lines.push(`${indent}\t<FormControlExtension i:nil="true" />`);
+    // Required child containers (recursive), plus field columns for a Grid.
+    const childSpecs = (spec.children ?? []).filter(isRequired).filter(isConcrete);
+    const childXml = childSpecs
+        .map((c) => emitNode(c, opt, depth + 2))
+        .filter(Boolean)
+        .join('\n');
+    let gridColumns = '';
+    if (controlType === 'Grid' && opt.dsName && (opt.gridFields?.length ?? 0) > 0) {
+        gridColumns = opt
+            .gridFields.map((f) => FormPatternTemplates.fieldControl(f, opt.dsName, '\t'.repeat(depth + 2), 'Grid_', opt.fieldTypes))
+            .join('')
+            .replace(/\n$/, '');
+    }
+    const inner = [childXml, gridColumns].filter(Boolean).join('\n');
+    if (inner) {
+        lines.push(`${indent}\t<Controls>`);
+        lines.push(inner);
+        lines.push(`${indent}\t</Controls>`);
+    }
+    else {
+        lines.push(`${indent}\t<Controls />`);
+    }
+    const props = emitProperties(spec.properties, `${indent}\t`);
+    if (props)
+        lines.push(props);
+    // Grid needs a DataSource binding to be useful (and FP-correct).
+    if (controlType === 'Grid' && opt.dsName) {
+        lines.push(`${indent}\t<DataSource>${opt.dsName}</DataSource>`);
+    }
+    lines.push(`${indent}</AxFormControl>`);
+    return lines.join('\n');
+}
+/** Build the <DataSources> block (primary + optional lines datasource). */
+function emitDataSources(opt) {
+    const ds = (name, table) => `\t\t<AxFormDataSource xmlns="">\n` +
+        `\t\t\t<Name>${name}</Name>\n` +
+        `\t\t\t<Table>${table}</Table>\n` +
+        `\t\t\t<Fields />\n` +
+        `\t\t\t<ReferencedDataSources />\n` +
+        `\t\t\t<InsertIfEmpty>No</InsertIfEmpty>\n` +
+        `\t\t\t<DataSourceLinks />\n` +
+        `\t\t\t<DerivedDataSources />\n` +
+        `\t\t</AxFormDataSource>`;
+    const blocks = [];
+    if (opt.dsName && opt.dsTable)
+        blocks.push(ds(opt.dsName, opt.dsTable));
+    if (opt.linesDsName && opt.linesDsTable)
+        blocks.push(ds(opt.linesDsName, opt.linesDsTable));
+    if (blocks.length === 0)
+        return `\t<DataSources />`;
+    return `\t<DataSources>\n${blocks.join('\n')}\n\t</DataSources>`;
+}
+/**
+ * Expand a form pattern spec into complete AxForm XML, deterministically and
+ * straight from the catalog. Used for patterns that have no dedicated
+ * hand-written template.
+ */
+export function expandPatternToXml(spec, opt) {
+    const version = spec.versions[0] ?? '1.0';
+    const style = spec.designProperties?.Style ?? spec.xmlName;
+    const caption = opt.caption ? `\t\t<Caption xmlns="">${opt.caption}</Caption>\n` : '';
+    const titleDs = opt.dsName ? `\t\t<TitleDataSource xmlns="">${opt.dsName}</TitleDataSource>\n` : '';
+    const designDs = opt.dsName ? `\t\t<DataSource xmlns="">${opt.dsName}</DataSource>\n` : '';
+    const controls = spec.root
+        .filter(isRequired)
+        .filter(isConcrete)
+        .map((node) => emitNode(node, opt, 3))
+        .filter(Boolean)
+        .join('\n');
+    const controlsBlock = controls
+        ? `\t\t<Controls xmlns="">\n${controls}\n\t\t</Controls>`
+        : `\t\t<Controls xmlns="" />`;
+    return (`<?xml version="1.0" encoding="utf-8"?>\n` +
+        `<AxForm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="Microsoft.Dynamics.AX.Metadata.V6">\n` +
+        `\t<Name>${opt.formName}</Name>\n` +
+        `\t<SourceCode>\n` +
+        `\t\t<Methods xmlns="">\n` +
+        `\t\t\t<Method>\n` +
+        `\t\t\t\t<Name>classDeclaration</Name>\n` +
+        `\t\t\t\t<Source><![CDATA[\n` +
+        `[Form]\n` +
+        `public class ${opt.formName} extends FormRun\n` +
+        `{\n` +
+        `}\n\n` +
+        `]]></Source>\n` +
+        `\t\t\t</Method>\n` +
+        `\t\t</Methods>\n` +
+        `\t\t<DataSources xmlns="" />\n` +
+        `\t\t<DataControls xmlns="" />\n` +
+        `\t\t<Members xmlns="" />\n` +
+        `\t</SourceCode>\n` +
+        `${emitDataSources(opt)}\n` +
+        `\t<Design>\n` +
+        `${caption}${designDs}` +
+        `\t\t<Pattern xmlns="">${spec.xmlName}</Pattern>\n` +
+        `\t\t<PatternVersion xmlns="">${version}</PatternVersion>\n` +
+        `\t\t<Style xmlns="">${style}</Style>\n` +
+        `${titleDs}` +
+        `${controlsBlock}\n` +
+        `\t</Design>\n` +
+        `\t<Parts />\n` +
+        `</AxForm>\n`);
+}
+//# sourceMappingURL=formControlExpander.js.map

package/dist/utils/formControlExpander.js.map

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

package/dist/utils/formControlRepair.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Form control repair: auto-fixes a form missing pattern-required top-level
+ * controls (FP003). Reads the form's declared pattern, works out which
+ * required top-level controls are absent, generates them from the catalog
+ * (via the deterministic expander), and splices them into the Design
+ * <Controls> collection at the spec-mandated position.
+ *
+ * The splice is a depth-aware string operation: existing controls are preserved
+ * byte-for-byte (children, methods, customisations untouched) — only the
+ * missing required controls are inserted. The whole form is never reserialized.
+ *
+ * Scope: top-level (direct Design child) required controls only. Missing
+ * children deeper inside a container, and sub-pattern attachment, are out of
+ * scope here (the validator still flags them as warnings/errors for the caller).
+ */
+import type { FormPatternSpec, NodeSpec } from '../knowledge/formPatterns/index.js';
+import { type ExpandFormOptions } from './formControlExpander.js';
+export interface RepairResult {
+    xml: string;
+    /** Controls that were generated and inserted. */
+    added: Array<{
+        id: string;
+        type: string;
+    }>;
+    /** Required controls that could not be auto-added (non-concrete / no Controls block). */
+    unfixable: Array<{
+        id: string;
+        reason: string;
+    }>;
+    /** True when the form XML was actually changed. */
+    changed: boolean;
+}
+interface DirectChild {
+    /** Normalized control type (e.g. 'ActionPane', 'Grid'). */
+    type: string;
+    /** Byte offset of this child's `<AxFormControl` within the Controls inner content. */
+    start: number;
+    /** Byte offset just past this child's `</AxFormControl>`. */
+    end: number;
+}
+/**
+ * Locate the Design-level <Controls> collection and return its inner-content
+ * span. The Design's own Controls is the first <Controls …> after <Design> —
+ * the SourceCode DataSources/DataControls collections live before <Design>, and
+ * nested control Controls live deeper. Returns null when the form has no
+ * Design or no expandable Controls block (e.g. self-closed and we keep it so).
+ */
+export declare function findDesignControls(xml: string): {
+    innerStart: number;
+    innerEnd: number;
+    selfClosed: boolean;
+    selfCloseAt?: number;
+} | null;
+/**
+ * Scan the Controls inner content for its DIRECT <AxFormControl> children,
+ * tracking nesting depth so nested controls are not mistaken for top-level ones.
+ */
+export declare function scanDirectChildren(inner: string): DirectChild[];
+/**
+ * Plan which required, concrete root specs are missing from the existing direct
+ * children, and the index (in the existing-children array) AFTER which each
+ * should be inserted to honour spec order. anchorIndex === -1 means prepend.
+ */
+export declare function planInsertions(rootSpecs: NodeSpec[], existing: DirectChild[]): {
+    missing: Array<{
+        spec: NodeSpec;
+        anchorIndex: number;
+    }>;
+    unfixable: Array<{
+        id: string;
+        reason: string;
+    }>;
+};
+/**
+ * Repair a form's missing required top-level controls. Pure — given the form
+ * XML, its resolved pattern spec and generation options. Returns the (possibly
+ * unchanged) XML plus what was added / could not be fixed.
+ */
+export declare function repairFormXml(xml: string, spec: FormPatternSpec, opt: ExpandFormOptions): RepairResult;
+export {};
+//# sourceMappingURL=formControlRepair.d.ts.map

package/dist/utils/formControlRepair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formControlRepair.d.ts","sourceRoot":"","sources":["../../src/utils/formControlRepair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,yFAAyF;IACzF,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,WAAW;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuB5F;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAkC/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,WAAW,EAAE,GACtB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAiC/G;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,iBAAiB,GACrB,YAAY,CA8Dd"}

package/dist/utils/formControlRepair.js

@@ -0,0 +1,203 @@
+/**
+ * Form control repair: auto-fixes a form missing pattern-required top-level
+ * controls (FP003). Reads the form's declared pattern, works out which
+ * required top-level controls are absent, generates them from the catalog
+ * (via the deterministic expander), and splices them into the Design
+ * <Controls> collection at the spec-mandated position.
+ *
+ * The splice is a depth-aware string operation: existing controls are preserved
+ * byte-for-byte (children, methods, customisations untouched) — only the
+ * missing required controls are inserted. The whole form is never reserialized.
+ *
+ * Scope: top-level (direct Design child) required controls only. Missing
+ * children deeper inside a container, and sub-pattern attachment, are out of
+ * scope here (the validator still flags them as warnings/errors for the caller).
+ */
+import { normalizeControlType } from '../metadata/formPatternMiner.js';
+import { buildControlXml, isConcrete, isRequired, } from './formControlExpander.js';
+const OPEN = '<AxFormControl';
+const CLOSE = '</AxFormControl>';
+/**
+ * Locate the Design-level <Controls> collection and return its inner-content
+ * span. The Design's own Controls is the first <Controls …> after <Design> —
+ * the SourceCode DataSources/DataControls collections live before <Design>, and
+ * nested control Controls live deeper. Returns null when the form has no
+ * Design or no expandable Controls block (e.g. self-closed and we keep it so).
+ */
+export function findDesignControls(xml) {
+    const designIdx = xml.indexOf('<Design');
+    if (designIdx < 0)
+        return null;
+    const designEnd = xml.indexOf('</Design>', designIdx);
+    const region = designEnd < 0 ? xml.slice(designIdx) : xml.slice(designIdx, designEnd);
+    const ctrlRel = region.search(/<Controls\b/);
+    if (ctrlRel < 0)
+        return null;
+    const ctrlAbs = designIdx + ctrlRel;
+    // Find the end of the opening <Controls ...> tag.
+    const tagEnd = xml.indexOf('>', ctrlAbs);
+    if (tagEnd < 0)
+        return null;
+    const openTag = xml.slice(ctrlAbs, tagEnd + 1);
+    if (openTag.endsWith('/>')) {
+        // Empty <Controls … /> — caller expands it into an open/close pair.
+        return { innerStart: ctrlAbs, innerEnd: tagEnd + 1, selfClosed: true, selfCloseAt: ctrlAbs };
+    }
+    const closeIdx = xml.indexOf('</Controls>', tagEnd);
+    if (closeIdx < 0)
+        return null;
+    return { innerStart: tagEnd + 1, innerEnd: closeIdx, selfClosed: false };
+}
+/** Resolve a direct child's normalized control type from its opening tag / <Type>. */
+function childType(childXml) {
+    const iType = childXml.match(/i:type="(AxForm\w+)"/)?.[1];
+    if (iType) {
+        const norm = normalizeControlType(iType);
+        if (norm)
+            return norm;
+    }
+    const typeEl = childXml.match(/<Type>([^<]+)<\/Type>/)?.[1];
+    return typeEl?.trim() ?? 'Control';
+}
+/**
+ * Scan the Controls inner content for its DIRECT <AxFormControl> children,
+ * tracking nesting depth so nested controls are not mistaken for top-level ones.
+ */
+export function scanDirectChildren(inner) {
+    const children = [];
+    let depth = 0;
+    let i = 0;
+    let currentStart = -1;
+    while (i < inner.length) {
+        const nextOpen = inner.indexOf(OPEN, i);
+        const nextClose = inner.indexOf(CLOSE, i);
+        if (nextOpen < 0 && nextClose < 0)
+            break;
+        if (nextClose < 0 || (nextOpen >= 0 && nextOpen < nextClose)) {
+            // Ensure it's a real element start ('<AxFormControl' followed by space, >, or />)
+            const after = inner[nextOpen + OPEN.length];
+            if (after === ' ' || after === '\t' || after === '\n' || after === '>' || after === '/') {
+                if (depth === 0)
+                    currentStart = nextOpen;
+                depth++;
+            }
+            i = nextOpen + OPEN.length;
+        }
+        else {
+            depth--;
+            if (depth === 0 && currentStart >= 0) {
+                const end = nextClose + CLOSE.length;
+                children.push({
+                    type: childType(inner.slice(currentStart, end)),
+                    start: currentStart,
+                    end,
+                });
+                currentStart = -1;
+            }
+            i = nextClose + CLOSE.length;
+        }
+    }
+    return children;
+}
+/**
+ * Plan which required, concrete root specs are missing from the existing direct
+ * children, and the index (in the existing-children array) AFTER which each
+ * should be inserted to honour spec order. anchorIndex === -1 means prepend.
+ */
+export function planInsertions(rootSpecs, existing) {
+    const missing = [];
+    const unfixable = [];
+    const consumed = new Array(existing.length).fill(false);
+    let anchorIndex = -1;
+    for (const spec of rootSpecs) {
+        if (!isRequired(spec)) {
+            // Optional spec — advance the anchor past a matching existing control so
+            // later required inserts land after it, but never insert it ourselves.
+            const j = existing.findIndex((c, idx) => !consumed[idx] && spec.controlTypes.includes(c.type));
+            if (j >= 0) {
+                consumed[j] = true;
+                anchorIndex = j;
+            }
+            continue;
+        }
+        if (!isConcrete(spec)) {
+            unfixable.push({ id: spec.id, reason: 'pattern slot accepts any control type — cannot auto-generate' });
+            continue;
+        }
+        const j = existing.findIndex((c, idx) => !consumed[idx] && spec.controlTypes.includes(c.type));
+        if (j >= 0) {
+            consumed[j] = true;
+            anchorIndex = j;
+        }
+        else {
+            missing.push({ spec, anchorIndex });
+        }
+    }
+    return { missing, unfixable };
+}
+/**
+ * Repair a form's missing required top-level controls. Pure — given the form
+ * XML, its resolved pattern spec and generation options. Returns the (possibly
+ * unchanged) XML plus what was added / could not be fixed.
+ */
+export function repairFormXml(xml, spec, opt) {
+    const loc = findDesignControls(xml);
+    if (!loc) {
+        return { xml, added: [], unfixable: [{ id: 'Design', reason: 'no Design <Controls> block found' }], changed: false };
+    }
+    // Normalize a self-closed <Controls … /> into an open/empty/close pair first.
+    let workXml = xml;
+    let innerStart;
+    let innerEnd;
+    if (loc.selfClosed) {
+        const tag = xml.slice(loc.innerStart, loc.innerEnd);
+        const opened = tag.replace(/\s*\/>$/, '>') + '\n' + '</Controls>';
+        workXml = xml.slice(0, loc.innerStart) + opened + xml.slice(loc.innerEnd);
+        innerStart = loc.innerStart + tag.replace(/\s*\/>$/, '>').length + 1;
+        innerEnd = innerStart;
+    }
+    else {
+        innerStart = loc.innerStart;
+        innerEnd = loc.innerEnd;
+    }
+    const inner = workXml.slice(innerStart, innerEnd);
+    const existing = scanDirectChildren(inner);
+    const { missing, unfixable } = planInsertions(spec.root, existing);
+    if (missing.length === 0) {
+        return { xml, added: [], unfixable, changed: false };
+    }
+    // Build the new inner content: walk existing children in order, emitting any
+    // generated controls whose anchorIndex points just before them.
+    const byAnchor = new Map();
+    const added = [];
+    for (const m of missing) {
+        const generated = buildControlXml(m.spec, opt, 3);
+        if (!generated) {
+            unfixable.push({ id: m.spec.id, reason: 'expander produced no XML for this slot' });
+            continue;
+        }
+        if (!byAnchor.has(m.anchorIndex))
+            byAnchor.set(m.anchorIndex, []);
+        byAnchor.get(m.anchorIndex).push('\n' + generated);
+        added.push({ id: m.spec.id, type: m.spec.controlTypes[0] });
+    }
+    if (added.length === 0) {
+        return { xml, added: [], unfixable, changed: false };
+    }
+    const pieces = [];
+    // Prepended (anchor -1) controls go first.
+    for (const g of byAnchor.get(-1) ?? [])
+        pieces.push(g);
+    for (let idx = 0; idx < existing.length; idx++) {
+        pieces.push(inner.slice(existing[idx].start, existing[idx].end));
+        for (const g of byAnchor.get(idx) ?? [])
+            pieces.push(g);
+    }
+    // Preserve whatever leading/trailing whitespace framed the original inner.
+    const leading = inner.slice(0, existing[0]?.start ?? inner.length);
+    const trailing = existing.length > 0 ? inner.slice(existing[existing.length - 1].end) : '';
+    const newInner = leading + pieces.join('') + trailing;
+    const newXml = workXml.slice(0, innerStart) + newInner + workXml.slice(innerEnd);
+    return { xml: newXml, added, unfixable, changed: true };
+}
+//# sourceMappingURL=formControlRepair.js.map

package/dist/utils/formControlRepair.js.map

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

package/dist/utils/formExtensionShapeValidator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Form-extension control-shape validator.
+ *
+ * Catches malformed AxFormExtension control shapes in hand-written `xmlContent`
+ * (the escape hatch when add-control can't be used) that would otherwise be
+ * silently accepted and then rejected by the D365FO deserializer.
+ *
+ * Correct shape (verified against shipped standard extensions, e.g.
+ * InventItemSampling.AdvancedQualityManagement):
+ *
+ *   <AxFormExtensionControl xmlns="">
+ *     <Name>FormExtensionControl{rand}</Name>
+ *     <FormControl xmlns="" i:type="AxFormIntegerControl">
+ *       <Name>Field</Name>
+ *       <Type>Integer</Type>
+ *       <FormControlExtension i:nil="true" />
+ *       <DataField>Field</DataField>
+ *       <DataSource>Table</DataSource>
+ *       <Label>@Model:Label</Label>
+ *     </FormControl>
+ *     <Parent>ParentControl</Parent>
+ *   </AxFormExtensionControl>
+ */
+export interface FormExtShapeProblem {
+    found: string;
+    expected: string;
+    detail: string;
+}
+/**
+ * The canonical correct shape, shown to the caller when a problem is found so they
+ * can fix it without grepping standard packages.
+ */
+export declare const CORRECT_FORM_EXTENSION_CONTROL_TEMPLATE: string;
+/**
+ * Inspect form-extension XML for the known malformed control shapes. Returns an empty
+ * array when the shape is fine. Pure + side-effect-free so it is trivially testable.
+ */
+export declare function validateFormExtensionControlShape(xml: string): FormExtShapeProblem[];
+/**
+ * Render a blocking error message for the detected problems, including the correct
+ * template so the caller can fix the XML in a single edit (no package grepping).
+ */
+export declare function buildFormExtensionShapeError(objectName: string, problems: FormExtShapeProblem[]): string;
+//# sourceMappingURL=formExtensionShapeValidator.d.ts.map

package/dist/utils/formExtensionShapeValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formExtensionShapeValidator.d.ts","sourceRoot":"","sources":["../../src/utils/formExtensionShapeValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,uCAAuC,QAYvB,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAgDpF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CAWR"}