d365fo-mcp 1.0.0

package/dist/utils/eolUtils.js

@@ -0,0 +1,21 @@
+/**
+ * EOL (line ending) detection utilities for file-writing operations.
+ *
+ * D365FO .label.txt files are Windows-native CRLF by convention (TFVC and Git
+ * both track them as CRLF). Tools that read-normalize-write must preserve the
+ * original line ending so VCS diffs only highlight the intentional changes.
+ */
+/**
+ * Detect the dominant line ending in a file's content.
+ * Any CRLF present is treated as evidence the whole file is CRLF; falls back
+ * to LF only when line endings exist but none are CRLF. Defaults to CRLF for
+ * brand-new or empty files to match D365FO conventions.
+ */
+export function detectEol(content) {
+    if (content.includes('\r\n'))
+        return '\r\n';
+    if (content.includes('\n'))
+        return '\n';
+    return '\r\n';
+}
+//# sourceMappingURL=eolUtils.js.map

package/dist/utils/eolUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eolUtils.js","sourceRoot":"","sources":["../../src/utils/eolUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/extractManifest.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Extract manifest — the bridge between `extract-metadata` and `build-database`.
+ *
+ * `extract-metadata` knows which models are custom (including UDE auto-detection from the
+ * ModelStoreFolder, where CUSTOM_MODELS is intentionally empty). `build-database` runs as a
+ * separate process that only sees CUSTOM_MODELS and therefore cannot repeat that detection.
+ *
+ * To keep the two phases' notion of "custom" in agreement without a hand-maintained
+ * CUSTOM_MODELS list, `extract-metadata` records the models it classified as custom in this
+ * manifest, written into the metadata output directory, and `build-database` reads it when
+ * scoping a `custom` rebuild.
+ */
+/** File written into the metadata output directory. Not a model dir — scanners skip files. */
+export declare const EXTRACT_MANIFEST_FILENAME = ".extract-manifest.json";
+export interface ExtractManifest {
+    /** ISO timestamp of the extract run that produced this manifest. */
+    generatedAt: string;
+    /** EXTRACT_MODE of the run: 'all' | 'custom' | 'standard'. */
+    extractMode: string;
+    /** 'ude' when custom models were path-auto-detected, else 'traditional'. */
+    environment: 'ude' | 'traditional';
+    /** Model names the extract run classified as custom (exact on-disk directory names). */
+    customModels: string[];
+}
+export declare function manifestPath(metadataDir: string): string;
+/** Write the manifest into `metadataDir`. Best-effort: extraction succeeds even if this fails. */
+export declare function writeExtractManifest(metadataDir: string, manifest: ExtractManifest): void;
+/**
+ * Read the list of custom models recorded by the last extract run.
+ * Returns `undefined` when no manifest exists (older extract, or none run yet), so callers
+ * can distinguish "no manifest" from "manifest with an empty custom list".
+ */
+export declare function readExtractedCustomModels(metadataDir: string): string[] | undefined;
+//# sourceMappingURL=extractManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractManifest.d.ts","sourceRoot":"","sources":["../../src/utils/extractManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,KAAK,GAAG,aAAa,CAAC;IACnC,wFAAwF;IACxF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEzF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAYnF"}

package/dist/utils/extractManifest.js

@@ -0,0 +1,43 @@
+/**
+ * Extract manifest — the bridge between `extract-metadata` and `build-database`.
+ *
+ * `extract-metadata` knows which models are custom (including UDE auto-detection from the
+ * ModelStoreFolder, where CUSTOM_MODELS is intentionally empty). `build-database` runs as a
+ * separate process that only sees CUSTOM_MODELS and therefore cannot repeat that detection.
+ *
+ * To keep the two phases' notion of "custom" in agreement without a hand-maintained
+ * CUSTOM_MODELS list, `extract-metadata` records the models it classified as custom in this
+ * manifest, written into the metadata output directory, and `build-database` reads it when
+ * scoping a `custom` rebuild.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** File written into the metadata output directory. Not a model dir — scanners skip files. */
+export const EXTRACT_MANIFEST_FILENAME = '.extract-manifest.json';
+export function manifestPath(metadataDir) {
+    return path.join(metadataDir, EXTRACT_MANIFEST_FILENAME);
+}
+/** Write the manifest into `metadataDir`. Best-effort: extraction succeeds even if this fails. */
+export function writeExtractManifest(metadataDir, manifest) {
+    fs.writeFileSync(manifestPath(metadataDir), JSON.stringify(manifest, null, 2));
+}
+/**
+ * Read the list of custom models recorded by the last extract run.
+ * Returns `undefined` when no manifest exists (older extract, or none run yet), so callers
+ * can distinguish "no manifest" from "manifest with an empty custom list".
+ */
+export function readExtractedCustomModels(metadataDir) {
+    try {
+        const raw = fs.readFileSync(manifestPath(metadataDir), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed.customModels)) {
+            return parsed.customModels.filter((m) => typeof m === 'string');
+        }
+        return undefined;
+    }
+    catch {
+        // No manifest (ENOENT) or unparseable — caller falls back to its default scoping.
+        return undefined;
+    }
+}
+//# sourceMappingURL=extractManifest.js.map

package/dist/utils/extractManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractManifest.js","sourceRoot":"","sources":["../../src/utils/extractManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,8FAA8F;AAC9F,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAalE,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;AAC3D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,QAAyB;IACjF,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6B,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,kFAAkF;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/fieldControlTypes.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Field type → form control type resolution.
+ *
+ * The indexed `symbols` table stores a uniform "String" signature for every
+ * field, so it cannot tell an enum from a date from a real. To emit the correct
+ * AxForm control for each field (ComboBox for enums, Date for dates, …) we read
+ * the field's real `i:type` straight from the table's AOT XML — which every
+ * indexed field row points at via its `file_path`.
+ *
+ * Mapping is driven by the field's AxTableField i:type (reliable, present on
+ * every field) rather than the EDT name, so it works for custom EDTs too.
+ */
+export interface ControlTypeInfo {
+    /** AxForm control i:type attribute, e.g. 'AxFormComboBoxControl' */
+    iType: string;
+    /** <Type> element value, e.g. 'ComboBox' */
+    typeValue: string;
+}
+/** Fallback when the field type is unknown — a plain string control is always valid. */
+export declare const DEFAULT_CONTROL: ControlTypeInfo;
+/**
+ * Resolve the form control for a table field, given its AxTableField i:type and
+ * (for enums) the bound enum name. NoYes enums become a CheckBox; every other
+ * enum a ComboBox — matching how shipped forms render them.
+ */
+export declare function controlForTableField(tableFieldIType: string, enumType?: string): ControlTypeInfo;
+/** field name (lower-cased) → resolved control type */
+export type FieldControlMap = Map<string, ControlTypeInfo>;
+/**
+ * Parse a table's AOT XML into a field→control-type map. Returns an empty map on
+ * any failure (missing file, parse issue) — callers fall back to String controls.
+ */
+export declare function parseTableFieldControls(tableXml: string): FieldControlMap;
+/**
+ * Build a field→control-type map for a table by locating its AOT XML through the
+ * symbol index (any field row of the table carries the table's `file_path`).
+ *
+ * @param db   read-only better-sqlite3 handle (symbolIndex.getReadDb())
+ * @param table table name
+ */
+export declare function getFieldControlMap(db: any, table: string): FieldControlMap;
+/** Control type for a single field from a (possibly undefined) map, defaulting to String. */
+export declare function controlForField(field: string, types?: FieldControlMap): ControlTypeInfo;
+//# sourceMappingURL=fieldControlTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldControlTypes.d.ts","sourceRoot":"","sources":["../../src/utils/fieldControlTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,eAAO,MAAM,eAAe,EAAE,eAG7B,CAAC;AAeF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAQhG;AAED,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAezE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAkB1E;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,eAAe,CAEvF"}

package/dist/utils/fieldControlTypes.js

@@ -0,0 +1,97 @@
+/**
+ * Field type → form control type resolution.
+ *
+ * The indexed `symbols` table stores a uniform "String" signature for every
+ * field, so it cannot tell an enum from a date from a real. To emit the correct
+ * AxForm control for each field (ComboBox for enums, Date for dates, …) we read
+ * the field's real `i:type` straight from the table's AOT XML — which every
+ * indexed field row points at via its `file_path`.
+ *
+ * Mapping is driven by the field's AxTableField i:type (reliable, present on
+ * every field) rather than the EDT name, so it works for custom EDTs too.
+ */
+import fs from 'fs';
+import { lookupSymbolNocase } from './symbolLookup.js';
+/** Fallback when the field type is unknown — a plain string control is always valid. */
+export const DEFAULT_CONTROL = {
+    iType: 'AxFormStringControl',
+    typeValue: 'String',
+};
+/** AxTableField i:type → AxForm control (enums handled separately in {@link controlForTableField}). */
+const TABLE_FIELD_TO_CONTROL = {
+    AxTableFieldString: { iType: 'AxFormStringControl', typeValue: 'String' },
+    AxTableFieldMemo: { iType: 'AxFormStringControl', typeValue: 'String' },
+    AxTableFieldInt: { iType: 'AxFormIntegerControl', typeValue: 'Integer' },
+    AxTableFieldInt64: { iType: 'AxFormInt64Control', typeValue: 'Int64' },
+    AxTableFieldReal: { iType: 'AxFormRealControl', typeValue: 'Real' },
+    AxTableFieldDate: { iType: 'AxFormDateControl', typeValue: 'Date' },
+    AxTableFieldUtcDateTime: { iType: 'AxFormDateTimeControl', typeValue: 'DateTime' },
+    AxTableFieldTime: { iType: 'AxFormTimeControl', typeValue: 'Time' },
+    AxTableFieldGuid: { iType: 'AxFormGuidControl', typeValue: 'Guid' },
+};
+/**
+ * Resolve the form control for a table field, given its AxTableField i:type and
+ * (for enums) the bound enum name. NoYes enums become a CheckBox; every other
+ * enum a ComboBox — matching how shipped forms render them.
+ */
+export function controlForTableField(tableFieldIType, enumType) {
+    if (tableFieldIType === 'AxTableFieldEnum') {
+        if (enumType && enumType.trim().toLowerCase() === 'noyes') {
+            return { iType: 'AxFormCheckBoxControl', typeValue: 'CheckBox' };
+        }
+        return { iType: 'AxFormComboBoxControl', typeValue: 'ComboBox' };
+    }
+    return TABLE_FIELD_TO_CONTROL[tableFieldIType] ?? DEFAULT_CONTROL;
+}
+/**
+ * Parse a table's AOT XML into a field→control-type map. Returns an empty map on
+ * any failure (missing file, parse issue) — callers fall back to String controls.
+ */
+export function parseTableFieldControls(tableXml) {
+    const map = new Map();
+    // Each <AxTableField … i:type="AxTableFieldXxx"> … </AxTableField> block.
+    // [^>]* spans the (possibly multi-line) opening tag up to its '>'.
+    const fieldRe = /<AxTableField\b[^>]*?i:type="(AxTableField\w+)"[^>]*>([\s\S]*?)<\/AxTableField>/g;
+    let m;
+    while ((m = fieldRe.exec(tableXml)) !== null) {
+        const iType = m[1];
+        const body = m[2];
+        const name = body.match(/<Name>([^<]+)<\/Name>/)?.[1]?.trim();
+        if (!name)
+            continue;
+        const enumType = body.match(/<EnumType>([^<]+)<\/EnumType>/)?.[1]?.trim();
+        map.set(name.toLowerCase(), controlForTableField(iType, enumType));
+    }
+    return map;
+}
+/**
+ * Build a field→control-type map for a table by locating its AOT XML through the
+ * symbol index (any field row of the table carries the table's `file_path`).
+ *
+ * @param db   read-only better-sqlite3 handle (symbolIndex.getReadDb())
+ * @param table table name
+ */
+export function getFieldControlMap(db, table) {
+    try {
+        // Canonicalize first — `parent_name = ? COLLATE NOCASE` cannot use
+        // idx_parent_type_name and scans all 360k field rows (180 s cold).
+        const canonical = lookupSymbolNocase(db, table)?.name ?? table;
+        const row = db
+            .prepare(`SELECT file_path FROM symbols
+         WHERE type = 'field' AND parent_name = ?
+           AND file_path IS NOT NULL AND file_path != ''
+         LIMIT 1`)
+            .get(canonical);
+        if (!row?.file_path || !fs.existsSync(row.file_path))
+            return new Map();
+        return parseTableFieldControls(fs.readFileSync(row.file_path, 'utf-8'));
+    }
+    catch {
+        return new Map();
+    }
+}
+/** Control type for a single field from a (possibly undefined) map, defaulting to String. */
+export function controlForField(field, types) {
+    return types?.get(field.toLowerCase()) ?? DEFAULT_CONTROL;
+}
+//# sourceMappingURL=fieldControlTypes.js.map

package/dist/utils/fieldControlTypes.js.map

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

package/dist/utils/formCloner.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Form Cloner — clones an existing AxForm XML into a new form, re-binding
+ * datasources/fields to target tables.
+ *
+ * All transformations are STRING-LEVEL on the original XML text — never
+ * parse/re-serialize. D365FO metadata XML is whitespace-, CDATA- and
+ * namespace-marker-sensitive (tabs, CRLF, xmlns="", i:nil), and a round-trip
+ * through an XML library corrupts it. Regions we don't touch stay byte-identical.
+ */
+export interface CloneFormOptions {
+    /** Name of the new form (already prefixed) */
+    targetFormName: string;
+    /** sourceTable → targetTable re-binding (omit to keep the source tables) */
+    tableMapping?: Record<string, string>;
+    /**
+     * Field lookup for a target table (case-insensitive names). Return null when
+     * the table is unknown — fields then pass through unfiltered.
+     */
+    getTableFields?: (table: string) => string[] | null;
+    /** Strip form/datasource methods except classDeclaration (default true) */
+    stripMethods?: boolean;
+    /** New Design caption (label ref or text). Replaces the source form's caption. */
+    caption?: string;
+}
+export interface CloneFormResult {
+    xml: string;
+    sourceFormName: string;
+    renamedDataSources: Array<{
+        from: string;
+        to: string;
+    }>;
+    droppedFields: Array<{
+        dataSource: string;
+        field: string;
+    }>;
+    removedControls: string[];
+    strippedMethods: string[];
+    /** True when the <SourceCode> datasource/control method mirror was emptied. */
+    clearedSourceCodeMirror: boolean;
+    /** True when the classDeclaration body (member vars/macros) was reset to empty. */
+    resetClassDeclaration: boolean;
+    /** Default datasource indexes dropped from re-bound datasources. */
+    removedIndexes: Array<{
+        dataSource: string;
+        index: string;
+    }>;
+    /** QuickFilter defaultColumnName references repointed/cleared after column removal. */
+    repointedQuickFilters: Array<{
+        from: string;
+        to: string;
+    }>;
+    /**
+     * Per-datasource field-retention stats for re-bound datasources whose target
+     * table fields were known. Lets callers detect a poor structural match (the
+     * reference form's table is unrelated to the target → most fields dropped).
+     */
+    fieldStats: Array<{
+        dataSource: string;
+        total: number;
+        dropped: number;
+    }>;
+}
+interface ElementBlock {
+    start: number;
+    end: number;
+    content: string;
+}
+/**
+ * Find all top-level blocks of `tagName` inside `xml` using balanced
+ * open/close counting (handles nested same-name elements, e.g. AxFormControl
+ * inside AxFormControl, AxFormDataSource inside DerivedDataSources).
+ * Self-closing tags (<Tag ... />) count as complete blocks.
+ */
+export declare function findElementBlocks(xml: string, tagName: string, searchStart?: number, searchEnd?: number): ElementBlock[];
+export declare function cloneFormXml(sourceXml: string, opt: CloneFormOptions): CloneFormResult;
+export {};
+//# sourceMappingURL=formCloner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formCloner.d.ts","sourceRoot":"","sources":["../../src/utils/formCloner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,aAAa,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,uBAAuB,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oEAAoE;IACpE,cAAc,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,uFAAuF;IACvF,qBAAqB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D;;;;OAIG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CA6CnH;AAqED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAkQtF"}