d365fo-mcp 1.0.0

package/dist/validation/formPatternValidator.js

@@ -0,0 +1,454 @@
+/**
+ * Form Pattern Validator — pure structural validator for AxForm XML against
+ * the curated form pattern catalog (src/knowledge/formPatterns).
+ *
+ * Rules:
+ *   FP001 (error)   unknown <Pattern> on Design / unknown sub-pattern on a container
+ *   FP002 (error)   unknown PatternVersion for a known pattern
+ *         (warning) known-but-older version, or version newer than catalog (PU drift)
+ *   FP003 (error)   required node missing (e.g. SimpleList without a Grid)
+ *   FP004 (error)   child control type not allowed in a patterned container
+ *   FP005 (error)   required children out of order (e.g. Grid before ActionPane)
+ *   FP006 (warning) container that requires a sub-pattern has none ("unspecified")
+ *   FP007 (error)   sub-pattern applied to an unsupported control type / parent pattern,
+ *                   or not allowed at this slot of the parent pattern
+ *   FP008 (warning) datasource expectation unmet (count / TitleDataSource)
+ *   FP009 (warning) Design/control property differs from the pattern default
+ *   FP010 (warning) no <Pattern> declared on Design at all
+ *
+ * Severity policy: only structural rules (FP001-FP005, FP007) are errors and
+ * may block writes; the rest are recommendations.
+ */
+import { Parser } from 'xml2js';
+import { walkFormDesign, } from '../metadata/formPatternMiner.js';
+import { resolvePatternExact, resolveSubPattern, knownPatternNames, } from '../knowledge/formPatterns/index.js';
+// Helpers
+const CONTAINER_TYPES = new Set(['Group', 'TabPage', 'Tab']);
+/**
+ * Composite platform controls whose internal child structure is managed by the
+ * platform, not by the form pattern. The financial DimensionEntryControl is the
+ * classic case: it nests its own Groups (one per dimension segment), which a
+ * pattern like FieldsFieldGroups would otherwise reject as "more than one level
+ * of group nesting". Faithful clones of real shipped forms (SalesTable etc.)
+ * legitimately contain these, so the validator treats them as opaque — accepted
+ * wherever input controls are allowed, and never descended into.
+ */
+const OPAQUE_CONTROL_TYPES = new Set([
+    'DimensionEntryControl',
+    'DimensionExpressionEntryControl',
+]);
+/** True for composite controls whose interior is not governed by form patterns. */
+function isOpaqueControl(node) {
+    if (OPAQUE_CONTROL_TYPES.has(node.type))
+        return true;
+    const hay = `${node.type} ${node.axType ?? ''}`.toLowerCase();
+    return /dimension(entry|expression)/.test(hay);
+}
+function nodePath(parentPath, node) {
+    return `${parentPath}/${node.type}[${node.name}]`;
+}
+function typeMatches(node, allowed) {
+    return allowed.includes('*') || allowed.includes(node.type);
+}
+function compareVersions(a, b) {
+    const pa = a.split('.').map((n) => parseInt(n, 10) || 0);
+    const pb = b.split('.').map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+function checkVersion(declared, knownVersions, patternLabel, path, violations) {
+    if (!declared) {
+        violations.push({
+            rule: 'FP002',
+            severity: 'warning',
+            path,
+            excerpt: `${patternLabel}: no PatternVersion declared`,
+            fix: `Add <PatternVersion>${knownVersions[0]}</PatternVersion>.`,
+        });
+        return;
+    }
+    if (knownVersions.includes(declared)) {
+        if (declared !== knownVersions[0]) {
+            violations.push({
+                rule: 'FP002',
+                severity: 'warning',
+                path,
+                excerpt: `${patternLabel}: version ${declared} is older than current ${knownVersions[0]}`,
+                fix: `Consider upgrading to PatternVersion ${knownVersions[0]}.`,
+            });
+        }
+        return;
+    }
+    const newest = knownVersions[0];
+    if (compareVersions(declared, newest) > 0) {
+        // Likely platform-update drift — the catalog lags behind, don't block
+        violations.push({
+            rule: 'FP002',
+            severity: 'warning',
+            path,
+            excerpt: `${patternLabel}: version ${declared} is newer than the catalog's ${newest}`,
+            fix: 'Probably a newer platform pattern version — update the catalog (versions list) after verifying.',
+        });
+    }
+    else {
+        violations.push({
+            rule: 'FP002',
+            severity: 'error',
+            path,
+            excerpt: `${patternLabel}: unknown version "${declared}" (known: ${knownVersions.join(', ')})`,
+            fix: `Use a known PatternVersion, typically ${newest}.`,
+        });
+    }
+}
+/**
+ * Match a container's actual children against the spec'd children.
+ * Emits FP003 (missing), FP004 (extra not allowed), FP005 (order) and returns
+ * matched pairs for recursion.
+ */
+function matchChildren(actual, specs, extra, ordered, parentPath, patternLabel, violations) {
+    const consumed = new Array(actual.length).fill(false);
+    const matched = [];
+    /** first actual index matched by each spec, in spec order (for FP005) */
+    const orderProbe = [];
+    for (const spec of specs) {
+        const indices = [];
+        for (let i = 0; i < actual.length; i++) {
+            if (consumed[i])
+                continue;
+            if (!typeMatches(actual[i], spec.controlTypes))
+                continue;
+            indices.push(i);
+            if (spec.occurrence === 'required' || spec.occurrence === 'optional')
+                break;
+        }
+        if (indices.length === 0) {
+            if (spec.occurrence === 'required' || spec.occurrence === 'oneOrMore') {
+                const basefix = `Add a ${spec.controlTypes[0]} control${spec.nameHint ? ` (conventionally named ${spec.nameHint})` : ''} under ${parentPath}.`;
+                const qfSnippet = spec.controlTypes[0] === 'QuickFilterControl'
+                    ? '\nQuickFilterControl requires a specific XML structure (NO i:type attribute, NOT <ExtensionName>):\n' +
+                        '<AxFormControl>\n' +
+                        '  <Name>QuickFilterControl</Name>\n' +
+                        '  <FormControlExtension>\n' +
+                        '    <Name>QuickFilterControl</Name>\n' +
+                        '    <ExtensionComponents />\n' +
+                        '    <ExtensionProperties>\n' +
+                        '      <AxFormControlExtensionProperty><Name>targetControlName</Name><Type>String</Type><Value>Grid</Value></AxFormControlExtensionProperty>\n' +
+                        '      <AxFormControlExtensionProperty><Name>defaultColumnName</Name><Type>String</Type><Value>ColumnName</Value></AxFormControlExtensionProperty>\n' +
+                        '    </ExtensionProperties>\n' +
+                        '  </FormControlExtension>\n' +
+                        '</AxFormControl>'
+                    : '';
+                violations.push({
+                    rule: 'FP003',
+                    severity: 'error',
+                    path: parentPath,
+                    excerpt: `${patternLabel}: required ${spec.controlTypes.join('/')} ("${spec.id}") is missing`,
+                    fix: basefix + qfSnippet,
+                });
+            }
+            continue;
+        }
+        for (const i of indices) {
+            consumed[i] = true;
+            matched.push({ spec, node: actual[i], actualIndex: i });
+        }
+        orderProbe.push({ specId: spec.id, firstIndex: Math.min(...indices) });
+    }
+    if (ordered) {
+        for (let i = 1; i < orderProbe.length; i++) {
+            if (orderProbe[i].firstIndex < orderProbe[i - 1].firstIndex) {
+                violations.push({
+                    rule: 'FP005',
+                    severity: 'error',
+                    path: parentPath,
+                    excerpt: `${patternLabel}: "${orderProbe[i].specId}" appears before "${orderProbe[i - 1].specId}" — pattern requires the opposite order`,
+                    fix: `Reorder the controls under ${parentPath}: ${specs.map((s) => s.id).join(' → ')}.`,
+                });
+            }
+        }
+    }
+    for (let i = 0; i < actual.length; i++) {
+        if (consumed[i])
+            continue;
+        const child = actual[i];
+        const allowedExtra = extra === 'any'
+            || isOpaqueControl(child)
+            || (Array.isArray(extra) && (extra.includes('*') || extra.includes(child.type)));
+        if (!allowedExtra) {
+            violations.push({
+                rule: 'FP004',
+                severity: 'error',
+                path: nodePath(parentPath, child),
+                excerpt: `${patternLabel}: control type "${child.type}" is not allowed here`,
+                fix: extra === 'none'
+                    ? `Remove or relocate "${child.name}" — only [${specs.map((s) => s.controlTypes.join('/')).join(', ')}] are allowed under ${parentPath}.`
+                    : `Move "${child.name}" elsewhere — allowed extra types here: ${extra.join(', ')}.`,
+            });
+        }
+    }
+    return matched;
+}
+/** Recursively apply a matched spec node to its actual control. */
+function applySpecToNode(pair, parentPath, patternLabel, topPatternId, violations) {
+    const { spec, node } = pair;
+    const path = nodePath(parentPath, node);
+    // FP009 — property defaults set by the pattern
+    if (spec.properties) {
+        for (const [prop, expected] of Object.entries(spec.properties)) {
+            const actualValue = node.properties[prop];
+            if (actualValue !== undefined && actualValue !== expected) {
+                violations.push({
+                    rule: 'FP009',
+                    severity: 'warning',
+                    path,
+                    excerpt: `${patternLabel}: ${prop}="${actualValue}" differs from pattern default "${expected}"`,
+                    fix: `Set ${prop} to "${expected}" unless the deviation is intentional.`,
+                });
+            }
+        }
+    }
+    // FP006 / FP007 — sub-pattern expectations on this slot
+    if (node.pattern) {
+        if (spec.allowedSubPatterns && spec.allowedSubPatterns.length > 0) {
+            const declared = resolveSubPattern(node.pattern);
+            const allowed = spec.allowedSubPatterns.some((name) => name.toLowerCase() === node.pattern.toLowerCase()
+                || declared?.id.toLowerCase() === name.toLowerCase());
+            if (!allowed) {
+                violations.push({
+                    rule: 'FP007',
+                    severity: 'error',
+                    path,
+                    excerpt: `${patternLabel}: sub-pattern "${node.pattern}" is not allowed on "${spec.id}" (allowed: ${spec.allowedSubPatterns.join(', ')})`,
+                    fix: `Apply one of: ${spec.allowedSubPatterns.join(', ')}.`,
+                });
+            }
+        }
+    }
+    else if (spec.requiresSubPattern) {
+        violations.push({
+            rule: 'FP006',
+            severity: 'warning',
+            path,
+            excerpt: `${patternLabel}: container "${node.name}" has no sub-pattern (unspecified)`,
+            fix: spec.allowedSubPatterns && spec.allowedSubPatterns.length > 0
+                ? `Apply a sub-pattern: ${spec.allowedSubPatterns.join(', ')}.`
+                : 'Apply an appropriate container sub-pattern (e.g. FieldsFieldGroups, ToolbarAndList).',
+        });
+    }
+    // Recurse into spec'd children. Also runs when the spec has no explicit
+    // children but restricts extras (e.g. one-level group nesting in
+    // FieldsFieldGroups) — the extraChildren policy must still be enforced.
+    const hasChildSpecs = (spec.children?.length ?? 0) > 0;
+    const restrictsExtras = spec.extraChildren !== undefined && spec.extraChildren !== 'any';
+    if (hasChildSpecs || restrictsExtras) {
+        const matched = matchChildren(node.children, spec.children ?? [], spec.extraChildren ?? 'any', spec.childrenOrdered ?? true, path, patternLabel, violations);
+        for (const childPair of matched) {
+            applySpecToNode(childPair, path, patternLabel, topPatternId, violations);
+        }
+    }
+}
+/**
+ * Walk the whole tree validating every declared sub-pattern, independent of
+ * whether the top-level spec covers that container.
+ */
+function validateSubPatternsDeep(nodes, parentPath, topPatternId, violations) {
+    for (const node of nodes) {
+        // Opaque composite controls (DimensionEntryControl …) own their interior —
+        // do not validate or descend into their managed child structure.
+        if (isOpaqueControl(node))
+            continue;
+        const path = nodePath(parentPath, node);
+        if (node.pattern) {
+            const sp = resolveSubPattern(node.pattern);
+            if (!sp) {
+                violations.push({
+                    rule: 'FP001',
+                    severity: 'error',
+                    path,
+                    excerpt: `Unknown sub-pattern "${node.pattern}" on ${node.type} "${node.name}"`,
+                    fix: 'Use a known container sub-pattern (e.g. FieldsFieldGroups, CustomAndQuickFilters, ToolbarAndList) or fix the spelling.',
+                });
+            }
+            else {
+                if (!sp.appliesToControlTypes.includes(node.type) && !sp.appliesToControlTypes.includes('*')) {
+                    violations.push({
+                        rule: 'FP007',
+                        severity: 'error',
+                        path,
+                        excerpt: `Sub-pattern "${sp.xmlName}" cannot be applied to control type "${node.type}" (applies to: ${sp.appliesToControlTypes.join(', ')})`,
+                        fix: `Move the sub-pattern to a ${sp.appliesToControlTypes[0]} container or choose a different sub-pattern.`,
+                    });
+                }
+                if (sp.parentPatterns && topPatternId && !sp.parentPatterns.includes(topPatternId)) {
+                    violations.push({
+                        rule: 'FP007',
+                        severity: 'error',
+                        path,
+                        excerpt: `Sub-pattern "${sp.xmlName}" is only valid inside ${sp.parentPatterns.join('/')} forms (this form: ${topPatternId})`,
+                        fix: 'Choose a sub-pattern supported by this form pattern.',
+                    });
+                }
+                checkVersion(node.patternVersion, sp.versions, `sub-pattern ${sp.xmlName}`, path, violations);
+                const matched = matchChildren(node.children, sp.root, sp.extraRootChildren ?? 'any', true, path, `sub-pattern ${sp.xmlName}`, violations);
+                for (const pair of matched) {
+                    applySpecToNode(pair, path, `sub-pattern ${sp.xmlName}`, topPatternId, violations);
+                }
+            }
+        }
+        validateSubPatternsDeep(node.children, path, topPatternId, violations);
+    }
+}
+function countContainers(nodes) {
+    let total = 0;
+    let patterned = 0;
+    const visit = (node) => {
+        if (isOpaqueControl(node))
+            return; // managed interior — not pattern containers
+        if (CONTAINER_TYPES.has(node.type)) {
+            total++;
+            if (node.pattern)
+                patterned++;
+        }
+        node.children.forEach(visit);
+    };
+    nodes.forEach(visit);
+    return { total, patterned };
+}
+// Public API
+/** Validate an already-walked design tree (used by tests and the miner path). */
+export function validateFormTree(facts) {
+    const { design, dataSourceCount, formName } = facts;
+    const violations = [];
+    const coverage = countContainers(design.controls);
+    const report = {
+        formName,
+        pattern: design.pattern,
+        patternVersion: design.patternVersion,
+        violations,
+        coverage: { containersTotal: coverage.total, containersPatterned: coverage.patterned },
+    };
+    let spec;
+    if (!design.pattern) {
+        violations.push({
+            rule: 'FP010',
+            severity: 'warning',
+            path: 'Design',
+            excerpt: 'Form declares no <Pattern> on Design',
+            fix: `Apply a form pattern (known: ${knownPatternNames().join(', ')}).`,
+        });
+    }
+    else {
+        spec = resolvePatternExact(design.pattern);
+        if (!spec) {
+            violations.push({
+                rule: 'FP001',
+                severity: 'error',
+                path: 'Design',
+                excerpt: `Unknown form pattern "${design.pattern}"`,
+                fix: `Use one of the known patterns: ${knownPatternNames().join(', ')}.`,
+            });
+        }
+    }
+    if (spec) {
+        const label = `pattern ${spec.xmlName}`;
+        checkVersion(design.patternVersion, spec.versions, label, 'Design', violations);
+        // FP009 — Design-level property defaults
+        if (spec.designProperties) {
+            for (const [prop, expected] of Object.entries(spec.designProperties)) {
+                const actualValue = prop === 'Style' ? design.style : design.properties[prop];
+                if (actualValue !== undefined && actualValue !== expected) {
+                    violations.push({
+                        rule: 'FP009',
+                        severity: 'warning',
+                        path: 'Design',
+                        excerpt: `${label}: ${prop}="${actualValue}" differs from pattern default "${expected}"`,
+                        fix: `Set Design.${prop} to "${expected}".`,
+                    });
+                }
+            }
+        }
+        // FP008 — datasource expectations
+        if (spec.requiresDataSource === 'one' && dataSourceCount < 1) {
+            violations.push({
+                rule: 'FP008',
+                severity: 'warning',
+                path: 'DataSources',
+                excerpt: `${label}: expects at least one datasource (found ${dataSourceCount})`,
+                fix: 'Add a primary AxFormDataSource bound to the entity table.',
+            });
+        }
+        if (spec.requiresDataSource === 'headerLines' && dataSourceCount < 2) {
+            violations.push({
+                rule: 'FP008',
+                severity: 'warning',
+                path: 'DataSources',
+                excerpt: `${label}: expects header + lines datasources (found ${dataSourceCount})`,
+                fix: 'Add both a header datasource and a lines datasource (linked via JoinSource).',
+            });
+        }
+        // Structural matching of Design children
+        const matched = matchChildren(design.controls, spec.root, spec.extraRootChildren ?? 'none', true, 'Design', label, violations);
+        for (const pair of matched) {
+            applySpecToNode(pair, 'Design', label, spec.id, violations);
+        }
+    }
+    // Deep sub-pattern validation across the entire tree
+    validateSubPatternsDeep(design.controls, 'Design', spec?.id, violations);
+    return report;
+}
+/** Parse AxForm XML and validate it against the catalog. */
+export async function validateFormPatternXml(xml) {
+    const parser = new Parser({ explicitArray: false, mergeAttrs: true, trim: true });
+    let parsed;
+    try {
+        parsed = await parser.parseStringPromise(xml);
+    }
+    catch (error) {
+        return {
+            violations: [
+                {
+                    rule: 'FP000',
+                    severity: 'error',
+                    path: '(document)',
+                    excerpt: `XML parse error: ${error instanceof Error ? error.message.split('\n')[0] : 'invalid XML'}`,
+                    fix: 'Fix the XML syntax before validating the pattern.',
+                },
+            ],
+            coverage: { containersTotal: 0, containersPatterned: 0 },
+        };
+    }
+    const axForm = parsed?.AxForm;
+    if (!axForm) {
+        return {
+            violations: [
+                {
+                    rule: 'FP000',
+                    severity: 'error',
+                    path: '(document)',
+                    excerpt: 'Not an AxForm document (missing <AxForm> root)',
+                    fix: 'Pass complete AxForm XML.',
+                },
+            ],
+            coverage: { containersTotal: 0, containersPatterned: 0 },
+        };
+    }
+    const design = walkFormDesign(axForm.Design);
+    let dataSourceCount = 0;
+    const dataSourcesNode = axForm.DataSources;
+    if (dataSourcesNode && typeof dataSourcesNode === 'object') {
+        const ds = dataSourcesNode.AxFormDataSource || dataSourcesNode.AxFormDataSourceRoot;
+        if (ds)
+            dataSourceCount = Array.isArray(ds) ? ds.length : 1;
+    }
+    const formName = typeof axForm.Name === 'string' ? axForm.Name : undefined;
+    return validateFormTree({ design, dataSourceCount, formName });
+}
+/** True when the report contains error-severity violations. */
+export function hasPatternErrors(report) {
+    return report.violations.some((v) => v.severity === 'error');
+}
+//# sourceMappingURL=formPatternValidator.js.map

package/dist/validation/formPatternValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formPatternValidator.js","sourceRoot":"","sources":["../../src/validation/formPatternValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,cAAc,GAGf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,oCAAoC,CAAC;AA2B5C,UAAU;AAEV,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,uBAAuB;IACvB,iCAAiC;CAClC,CAAC,CAAC;AAEH,mFAAmF;AACnF,SAAS,eAAe,CAAC,IAAqB;IAC5C,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkB,EAAE,IAAqB;IACzD,OAAO,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,IAAqB,EAAE,OAAiB;IAC3D,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,YAAY,CACnB,QAA4B,EAC5B,aAAuB,EACvB,YAAoB,EACpB,IAAY,EACZ,UAAkC;IAElC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,SAAS;YACnB,IAAI;YACJ,OAAO,EAAE,GAAG,YAAY,8BAA8B;YACtD,GAAG,EAAE,uBAAuB,aAAa,CAAC,CAAC,CAAC,oBAAoB;SACjE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,IAAI,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,SAAS;gBACnB,IAAI;gBACJ,OAAO,EAAE,GAAG,YAAY,aAAa,QAAQ,0BAA0B,aAAa,CAAC,CAAC,CAAC,EAAE;gBACzF,GAAG,EAAE,wCAAwC,aAAa,CAAC,CAAC,CAAC,GAAG;aACjE,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,sEAAsE;QACtE,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,SAAS;YACnB,IAAI;YACJ,OAAO,EAAE,GAAG,YAAY,aAAa,QAAQ,gCAAgC,MAAM,EAAE;YACrF,GAAG,EAAE,iGAAiG;SACvG,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,OAAO;YACjB,IAAI;YACJ,OAAO,EAAE,GAAG,YAAY,sBAAsB,QAAQ,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC9F,GAAG,EAAE,yCAAyC,MAAM,GAAG;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAUD;;;;GAIG;AACH,SAAS,aAAa,CACpB,MAAyB,EACzB,KAAiB,EACjB,KAA0B,EAC1B,OAAgB,EAChB,UAAkB,EAClB,YAAoB,EACpB,UAAkC;IAElC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,yEAAyE;IACzE,MAAM,UAAU,GAAkD,EAAE,CAAC;IAErE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,QAAQ,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;gBAAE,SAAS;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,MAAM;QAC9E,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;gBACtE,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,UAAU,GAAG,CAAC;gBAC/I,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,oBAAoB;oBAC7D,CAAC,CAAC,sGAAsG;wBACtG,mBAAmB;wBACnB,qCAAqC;wBACrC,4BAA4B;wBAC5B,uCAAuC;wBACvC,+BAA+B;wBAC/B,6BAA6B;wBAC7B,+IAA+I;wBAC/I,qJAAqJ;wBACrJ,8BAA8B;wBAC9B,6BAA6B;wBAC7B,kBAAkB;oBACpB,CAAC,CAAC,EAAE,CAAC;gBACP,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,GAAG,YAAY,cAAc,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,eAAe;oBAC7F,GAAG,EAAE,OAAO,GAAG,SAAS;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;gBAC5D,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,GAAG,YAAY,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,qBAAqB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,yCAAyC;oBACxI,GAAG,EAAE,8BAA8B,UAAU,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;iBACxF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,YAAY,GAChB,KAAK,KAAK,KAAK;eACZ,eAAe,CAAC,KAAK,CAAC;eACtB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;gBACjC,OAAO,EAAE,GAAG,YAAY,mBAAmB,KAAK,CAAC,IAAI,uBAAuB;gBAC5E,GAAG,EACD,KAAK,KAAK,MAAM;oBACd,CAAC,CAAC,uBAAuB,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,UAAU,GAAG;oBACzI,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,2CAA4C,KAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACtG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mEAAmE;AACnE,SAAS,eAAe,CACtB,IAAiB,EACjB,UAAkB,EAClB,YAAoB,EACpB,YAAgC,EAChC,UAAkC;IAElC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAExC,+CAA+C;IAC/C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;gBAC1D,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,SAAS;oBACnB,IAAI;oBACJ,OAAO,EAAE,GAAG,YAAY,KAAK,IAAI,KAAK,WAAW,mCAAmC,QAAQ,GAAG;oBAC/F,GAAG,EAAE,OAAO,IAAI,QAAQ,QAAQ,wCAAwC;iBACzE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,OAAQ,CAAC,WAAW,EAAE;mBACvD,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACvD,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI;oBACJ,OAAO,EAAE,GAAG,YAAY,kBAAkB,IAAI,CAAC,OAAO,wBAAwB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACzI,GAAG,EAAE,iBAAiB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;iBAC5D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,SAAS;YACnB,IAAI;YACJ,OAAO,EAAE,GAAG,YAAY,gBAAgB,IAAI,CAAC,IAAI,oCAAoC;YACrF,GAAG,EACD,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;gBAC3D,CAAC,CAAC,wBAAwB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC/D,CAAC,CAAC,sFAAsF;SAC7F,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,iEAAiE;IACjE,wEAAwE;IACxE,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC;IACzF,IAAI,aAAa,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,aAAa,CAC3B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,IAAI,EAAE,EACnB,IAAI,CAAC,aAAa,IAAI,KAAK,EAC3B,IAAI,CAAC,eAAe,IAAI,IAAI,EAC5B,IAAI,EACJ,YAAY,EACZ,UAAU,CACX,CAAC;QACF,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,KAAwB,EACxB,UAAkB,EAClB,YAAgC,EAChC,UAAkC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,2EAA2E;QAC3E,iEAAiE;QACjE,IAAI,eAAe,CAAC,IAAI,CAAC;YAAE,SAAS;QAEpC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI;oBACJ,OAAO,EAAE,wBAAwB,IAAI,CAAC,OAAO,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG;oBAC/E,GAAG,EAAE,wHAAwH;iBAC9H,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7F,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,OAAO;wBACjB,IAAI;wBACJ,OAAO,EAAE,gBAAgB,EAAE,CAAC,OAAO,wCAAwC,IAAI,CAAC,IAAI,kBAAkB,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBAC5I,GAAG,EAAE,6BAA6B,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,+CAA+C;qBAC7G,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,EAAE,CAAC,cAAc,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;oBACnF,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,OAAO;wBACjB,IAAI;wBACJ,OAAO,EAAE,gBAAgB,EAAE,CAAC,OAAO,0BAA0B,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,YAAY,GAAG;wBAC7H,GAAG,EAAE,sDAAsD;qBAC5D,CAAC,CAAC;gBACL,CAAC;gBACD,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBAE9F,MAAM,OAAO,GAAG,aAAa,CAC3B,IAAI,CAAC,QAAQ,EACb,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,iBAAiB,IAAI,KAAK,EAC7B,IAAI,EACJ,IAAI,EACJ,eAAe,EAAE,CAAC,OAAO,EAAE,EAC3B,UAAU,CACX,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;oBAC3B,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;QACH,CAAC;QAED,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAwB;IAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,CAAC,IAAqB,EAAQ,EAAE;QAC5C,IAAI,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,4CAA4C;QAC/E,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,KAAK,EAAE,CAAC;YACR,IAAI,IAAI,CAAC,OAAO;gBAAE,SAAS,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED,aAAa;AAEb,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAElD,MAAM,MAAM,GAAsB;QAChC,QAAQ;QACR,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU;QACV,QAAQ,EAAE,EAAE,eAAe,EAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,CAAC,SAAS,EAAE;KACvF,CAAC;IAEF,IAAI,IAAiC,CAAC;IAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sCAAsC;YAC/C,GAAG,EAAE,gCAAgC,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;SACxE,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,yBAAyB,MAAM,CAAC,OAAO,GAAG;gBACnD,GAAG,EAAE,kCAAkC,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACzE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEhF,yCAAyC;QACzC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACrE,MAAM,WAAW,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC9E,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;oBAC1D,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,SAAS;wBACnB,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,GAAG,KAAK,KAAK,IAAI,KAAK,WAAW,mCAAmC,QAAQ,GAAG;wBACxF,GAAG,EAAE,cAAc,IAAI,QAAQ,QAAQ,IAAI;qBAC5C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,IAAI,IAAI,CAAC,kBAAkB,KAAK,KAAK,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAC7D,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,GAAG,KAAK,4CAA4C,eAAe,GAAG;gBAC/E,GAAG,EAAE,2DAA2D;aACjE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,KAAK,aAAa,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,GAAG,KAAK,+CAA+C,eAAe,GAAG;gBAClF,GAAG,EAAE,8EAA8E;aACpF,CAAC,CAAC;QACL,CAAC;QAED,yCAAyC;QACzC,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,QAAQ,EACf,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,iBAAiB,IAAI,MAAM,EAChC,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,UAAU,CACX,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,uBAAuB,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAEzE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW;IACtD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE;oBACpG,GAAG,EAAE,mDAAmD;iBACzD;aACF;YACD,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,gDAAgD;oBACzD,GAAG,EAAE,2BAA2B;iBACjC;aACF;YACD,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3C,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,EAAE,GAAG,eAAe,CAAC,gBAAgB,IAAI,eAAe,CAAC,oBAAoB,CAAC;QACpF,IAAI,EAAE;YAAE,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,OAAO,gBAAgB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,MAAyB;IACxD,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/workspace/contextRanker.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Context Ranker — Phase 2 of the context pipeline.
+ *
+ * Given a free-text intent (e.g. a prepare `goal`) and an optional active
+ * object, rank the most relevant symbols from the codebase and return a
+ * token-budgeted neighborhood that grounds the next generation step.
+ *
+ * Index-only and deterministic: candidates come from the FTS5 index, scoring
+ * uses precomputed xref/usage signals (no bridge call needed), and each item
+ * carries explainable `reasons`. Every index access is guarded so a
+ * missing/empty index yields an empty ranking rather than an error.
+ */
+import type { XppServerContext } from '../types/context.js';
+export interface RankContextInput {
+    /** Free-text description of the goal/intent. */
+    intent: string;
+    /** Object currently in focus, used as a relationship anchor. */
+    activeObject?: {
+        name: string;
+        type?: string;
+    };
+    /** Max items to return after budgeting (default 12). */
+    limit?: number;
+    /** Approximate token budget for the rendered neighborhood (default 700). */
+    tokenBudget?: number;
+    /** Restrict candidate symbol types (e.g. ['class','table']). */
+    types?: string[];
+}
+export interface RankedItem {
+    name: string;
+    type: string;
+    model: string;
+    parentName?: string;
+    signature?: string;
+    score: number;
+    reasons: string[];
+}
+export interface RankedContext {
+    intent: string;
+    activeObject?: {
+        name: string;
+        type?: string;
+    };
+    items: RankedItem[];
+    /** True when candidates were dropped to fit the budget/limit. */
+    truncated: boolean;
+    approxTokens: number;
+}
+/** Split free text into meaningful lowercase tokens (≥3 chars, no stopwords). */
+export declare function tokenizeIntent(intent: string): string[];
+/**
+ * Rank relevant symbols for an intent + optional active object.
+ * Returns a token-budgeted, explainable neighborhood. Never throws.
+ */
+export declare function rankContext(context: XppServerContext, input: RankContextInput): RankedContext;
+/** Render a ranked neighborhood as markdown lines for tool output. */
+export declare function renderRankedContext(ranked: RankedContext): string[];
+//# sourceMappingURL=contextRanker.d.ts.map

package/dist/workspace/contextRanker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextRanker.d.ts","sourceRoot":"","sources":["../../src/workspace/contextRanker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAcD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CASvD;AAsBD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,gBAAgB,GACtB,aAAa,CAoJf;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAenE"}