d365fo-mcp 1.0.0

package/dist/knowledge/formPatterns/catalog/topLevel/wizard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wizard form pattern.
+ * https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/user-interface/wizard-form-pattern
+ */
+import type { FormPatternSpec } from '../../types.js';
+export declare const wizard: FormPatternSpec;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/knowledge/formPatterns/catalog/topLevel/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../../../../src/knowledge/formPatterns/catalog/topLevel/wizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,MAAM,EAAE,eAqCpB,CAAC"}

package/dist/knowledge/formPatterns/catalog/topLevel/wizard.js

@@ -0,0 +1,42 @@
+/**
+ * Wizard form pattern.
+ * https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/user-interface/wizard-form-pattern
+ */
+export const wizard = {
+    id: 'Wizard',
+    xmlName: 'Wizard',
+    displayName: 'Wizard',
+    versions: ['1.2', '1.1', '1.0'],
+    purpose: 'Displays a sequence of tab pages gathering information in a predetermined order, ' +
+        'navigated with Back/Next/Finish buttons (backed by a SysWizard class).',
+    whenToUse: [
+        'Multi-step guided input where order matters',
+        'Setup/onboarding flows broken into discrete steps',
+    ],
+    whenNotToUse: ['A single set of inputs → Dialog'],
+    referenceForms: ['WrkCtrBulkResReqEditWizard'],
+    requiresDataSource: 'none',
+    root: [
+        {
+            id: 'WizardTabs',
+            controlTypes: ['Tab'],
+            occurrence: 'required',
+            children: [
+                { id: 'WizardStep', controlTypes: ['TabPage'], occurrence: 'oneOrMore', extraChildren: 'any' },
+            ],
+            extraChildren: 'none',
+        },
+        {
+            id: 'NavigationButtons',
+            controlTypes: ['ButtonGroup', 'Group'],
+            occurrence: 'optional',
+            extraChildren: 'any',
+        },
+    ],
+    extraRootChildren: 'any',
+    lifecycleGuidance: [
+        'Pair the form with a SysWizard subclass driving step navigation and validation.',
+        'Override form init() to wire the wizard class; validate each step in the wizard class, not the form.',
+    ],
+};
+//# sourceMappingURL=wizard.js.map

package/dist/knowledge/formPatterns/catalog/topLevel/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../../../../src/knowledge/formPatterns/catalog/topLevel/wizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,MAAM,GAAoB;IACrC,EAAE,EAAE,QAAQ;IACZ,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC/B,OAAO,EACL,mFAAmF;QACnF,wEAAwE;IAC1E,SAAS,EAAE;QACT,6CAA6C;QAC7C,mDAAmD;KACpD;IACD,YAAY,EAAE,CAAC,iCAAiC,CAAC;IACjD,cAAc,EAAE,CAAC,4BAA4B,CAAC;IAC9C,kBAAkB,EAAE,MAAM;IAC1B,IAAI,EAAE;QACJ;YACE,EAAE,EAAE,YAAY;YAChB,YAAY,EAAE,CAAC,KAAK,CAAC;YACrB,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE;gBACR,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE;aAC/F;YACD,aAAa,EAAE,MAAM;SACtB;QACD;YACE,EAAE,EAAE,mBAAmB;YACvB,YAAY,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;YACtC,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE,KAAK;SACrB;KACF;IACD,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE;QACjB,iFAAiF;QACjF,sGAAsG;KACvG;CACF,CAAC"}

package/dist/knowledge/formPatterns/catalog/topLevel/workspace.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Workspace form patterns.
+ * https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/user-interface/workspace-form-pattern
+ *
+ * Two flavors exist in metadata:
+ *  - 'Workspace' — the original tabbed-panorama workspace (used by the local template)
+ *  - 'WorkspaceOperational' — the preferred, performance-enhanced operational workspace
+ * Exact xmlNames/versions are cross-checked by mining (Phase 3).
+ */
+import type { FormPatternSpec } from '../../types.js';
+export declare const workspacePanorama: FormPatternSpec;
+export declare const formPartSectionList: FormPatternSpec;
+export declare const formPartSectionListDouble: FormPatternSpec;
+export declare const hubPartChart: FormPatternSpec;
+export declare const hubPartGrid: FormPatternSpec;
+export declare const workspaceOperational: FormPatternSpec;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/knowledge/formPatterns/catalog/topLevel/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../src/knowledge/formPatterns/catalog/topLevel/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,eAAO,MAAM,iBAAiB,EAAE,eA4C/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAsBjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eA4BvC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAc1B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAczB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAsBlC,CAAC"}

package/dist/knowledge/formPatterns/catalog/topLevel/workspace.js

@@ -0,0 +1,157 @@
+/**
+ * Workspace form patterns.
+ * https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/user-interface/workspace-form-pattern
+ *
+ * Two flavors exist in metadata:
+ *  - 'Workspace' — the original tabbed-panorama workspace (used by the local template)
+ *  - 'WorkspaceOperational' — the preferred, performance-enhanced operational workspace
+ * Exact xmlNames/versions are cross-checked by mining (Phase 3).
+ */
+import { actionPane } from './common.js';
+export const workspacePanorama = {
+    id: 'Workspace',
+    xmlName: 'TabbedWorkspace',
+    xmlAliases: ['Workspace'],
+    displayName: 'Workspace (Tabbed Panorama)',
+    versions: ['1.0'],
+    purpose: 'Activity overview page: a horizontally scrolling panorama with a tile/KPI summary section ' +
+        'followed by list/chart/link sections. Primary means of navigation for an activity.',
+    whenToUse: [
+        'Overview dashboard for an operational activity (work queues, KPIs, quick links)',
+        'Primary navigation hub combining tiles, lists, and links',
+    ],
+    whenNotToUse: [
+        'New workspaces should prefer the Operational Workspace pattern',
+        'Entity maintenance → Details Master / Simple List',
+    ],
+    referenceForms: ['FmClerkWorkspace'],
+    designProperties: { Style: 'Workspace' },
+    requiresDataSource: 'none',
+    root: [
+        actionPane('optional'),
+        {
+            id: 'PanoramaBody',
+            controlTypes: ['Tab'],
+            occurrence: 'required',
+            nameHint: 'PanoramaBody',
+            properties: { Style: 'Panorama' },
+            children: [
+                {
+                    id: 'PanoramaSection',
+                    controlTypes: ['TabPage'],
+                    occurrence: 'oneOrMore',
+                    extraChildren: 'any',
+                },
+            ],
+            extraChildren: 'none',
+        },
+    ],
+    extraRootChildren: 'any',
+    lifecycleGuidance: [
+        'Tile counts come from menu items with query-based counts or unbound fields refreshed in executeQuery().',
+        'Each panorama list section typically binds its own datasource or Form Part.',
+    ],
+};
+export const formPartSectionList = {
+    id: 'FormPartSectionList',
+    xmlName: 'FormPartSectionList',
+    xmlAliases: ['SectionList', 'WorkspaceSectionList'],
+    displayName: 'Form Part Section List',
+    versions: ['1.2', '1.1', '1.0'],
+    purpose: 'A list shown in a workspace section — modeled as a separate form and rendered in the ' +
+        'workspace via a Form Part control.',
+    whenToUse: ['List section of an Operational Workspace (work queue, recent items)'],
+    referenceForms: ['FMRentalsToStartPart'],
+    requiresDataSource: 'one',
+    root: [
+        {
+            id: 'SectionBody',
+            controlTypes: ['Group', 'Grid'],
+            occurrence: 'oneOrMore',
+            extraChildren: 'any',
+        },
+    ],
+    extraRootChildren: 'any',
+    notes: ['Variant "Section List - Double" adds a secondary hidden list.'],
+};
+export const formPartSectionListDouble = {
+    id: 'FormPartSectionListDouble',
+    xmlName: 'FormPartSectionListDouble',
+    xmlAliases: ['SectionListDouble', 'WorkspaceSectionListDouble'],
+    variantOf: 'FormPartSectionList',
+    displayName: 'Form Part Section List - Double',
+    versions: ['1.2', '1.1', '1.0'],
+    purpose: 'A workspace section list with two lists — the primary visible list and a secondary hidden ' +
+        'list that becomes visible on toggle (e.g. "My" vs "All" tasks).',
+    whenToUse: ['Work-queue section that offers two list views the user can switch between'],
+    referenceForms: ['FMRentalsDoubleListPart'],
+    requiresDataSource: 'one',
+    root: [
+        {
+            id: 'PrimaryList',
+            controlTypes: ['Group', 'Grid'],
+            occurrence: 'required',
+            extraChildren: 'any',
+        },
+        {
+            id: 'SecondaryList',
+            controlTypes: ['Group', 'Grid'],
+            occurrence: 'optional',
+            extraChildren: 'any',
+        },
+    ],
+    extraRootChildren: 'any',
+};
+export const hubPartChart = {
+    id: 'HubPartChart',
+    xmlName: 'HubPartChart',
+    xmlAliases: ['SectionChart', 'WorkspaceSectionChart'],
+    displayName: 'Hub Part Chart',
+    versions: ['1.0'],
+    purpose: 'A chart shown in a workspace section via a Form Part control.',
+    whenToUse: ['Chart section of an Operational Workspace'],
+    referenceForms: ['VendInvoiceJourCountChart'],
+    requiresDataSource: 'none',
+    root: [
+        { id: 'Chart', controlTypes: ['*'], occurrence: 'required' },
+    ],
+    extraRootChildren: 'any',
+};
+export const hubPartGrid = {
+    id: 'HubPartGrid',
+    xmlName: 'HubPartGrid',
+    xmlAliases: ['SectionGrid', 'WorkspaceSectionGrid'],
+    displayName: 'Hub Part Grid',
+    versions: ['1.0'],
+    purpose: 'A grid shown in a workspace section via a Form Part control.',
+    whenToUse: ['Grid/list section of an Operational Workspace rendered as a Form Part'],
+    referenceForms: ['SalesOrderProcessingWorkspaceGrid'],
+    requiresDataSource: 'one',
+    root: [
+        { id: 'Grid', controlTypes: ['Grid'], occurrence: 'required', extraChildren: 'any' },
+    ],
+    extraRootChildren: 'any',
+};
+export const workspaceOperational = {
+    id: 'WorkspaceOperational',
+    xmlName: 'WorkspaceOperational',
+    variantOf: 'Workspace',
+    displayName: 'Operational Workspace',
+    versions: ['1.1', '1.0'],
+    purpose: 'The preferred, performance-enhanced workspace variant: sections render via Form Part ' +
+        'controls so content loads on demand.',
+    whenToUse: ['All new workspaces'],
+    referenceForms: ['FmClerkWorkspace', 'SalesOrderProcessingWorkspace'],
+    requiresDataSource: 'none',
+    root: [
+        actionPane('optional'),
+        {
+            id: 'PanoramaBody',
+            controlTypes: ['Tab'],
+            occurrence: 'required',
+            extraChildren: 'any',
+        },
+    ],
+    extraRootChildren: 'any',
+};
+//# sourceMappingURL=workspace.js.map

package/dist/knowledge/formPatterns/catalog/topLevel/workspace.js.map

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

package/dist/knowledge/formPatterns/crossCheck.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Catalog ↔ mined-data cross-check.
+ *
+ * Compares the curated form pattern catalog against the form_patterns table
+ * mined from real metadata during build-database. Surfaces:
+ *   - catalog gaps     : patterns used by real forms but unknown to the catalog
+ *   - suspect entries  : catalog patterns with zero mined usage (possible
+ *                        xmlName typo or environment without that area)
+ *   - version drift    : mined PatternVersions missing from the catalog's
+ *                        versions list (platform updates bumping versions)
+ */
+export interface CrossCheckReport {
+    minedFormCount: number;
+    /** mined pattern → usage count, unknown to the catalog (top-level Design only) */
+    catalogGaps: Array<{
+        pattern: string;
+        forms: number;
+    }>;
+    /** mined sub-pattern → usage count, unknown to the catalog */
+    subPatternGaps: Array<{
+        pattern: string;
+        containers: number;
+    }>;
+    /** catalog xmlNames with zero mined usage */
+    unusedCatalogEntries: string[];
+    /** known pattern, mined version not in the catalog versions list */
+    versionDrift: Array<{
+        pattern: string;
+        version: string;
+        forms: number;
+    }>;
+}
+interface ReadDbLike {
+    prepare(sql: string): {
+        all(...params: unknown[]): unknown[];
+        get(...params: unknown[]): unknown;
+    };
+}
+/** True when the form_patterns table has mined data (cached per index instance). */
+export declare function hasMinedPatternData(db: ReadDbLike): boolean;
+export declare function crossCheckPatternCatalog(db: ReadDbLike): CrossCheckReport | null;
+export declare function formatCrossCheckReport(report: CrossCheckReport): string;
+export {};
+//# sourceMappingURL=crossCheck.d.ts.map

package/dist/knowledge/formPatterns/crossCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossCheck.d.ts","sourceRoot":"","sources":["../../../src/knowledge/formPatterns/crossCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,8DAA8D;IAC9D,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oEAAoE;IACpE,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,UAAU,UAAU;IAClB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAAC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;KAAE,CAAC;CACpG;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAO3D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI,CA8DhF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}

package/dist/knowledge/formPatterns/crossCheck.js

@@ -0,0 +1,109 @@
+/**
+ * Catalog ↔ mined-data cross-check.
+ *
+ * Compares the curated form pattern catalog against the form_patterns table
+ * mined from real metadata during build-database. Surfaces:
+ *   - catalog gaps     : patterns used by real forms but unknown to the catalog
+ *   - suspect entries  : catalog patterns with zero mined usage (possible
+ *                        xmlName typo or environment without that area)
+ *   - version drift    : mined PatternVersions missing from the catalog's
+ *                        versions list (platform updates bumping versions)
+ */
+import { FORM_PATTERN_CATALOG, resolvePatternExact, resolveSubPattern } from './index.js';
+/** True when the form_patterns table has mined data (cached per index instance). */
+export function hasMinedPatternData(db) {
+    try {
+        const row = db.prepare(`SELECT COUNT(*) AS c FROM form_patterns`).get();
+        return (row?.c ?? 0) > 0;
+    }
+    catch {
+        return false; // table missing — index built by an older version
+    }
+}
+export function crossCheckPatternCatalog(db) {
+    if (!hasMinedPatternData(db))
+        return null;
+    const designRows = db.prepare(`
+    SELECT pattern, pattern_version, COUNT(*) AS forms
+    FROM form_patterns WHERE node_path = 'Design'
+    GROUP BY pattern, pattern_version
+  `).all();
+    const subRows = db.prepare(`
+    SELECT pattern, COUNT(*) AS containers
+    FROM form_patterns WHERE node_path != 'Design'
+    GROUP BY pattern
+  `).all();
+    const totalForms = db.prepare(`
+    SELECT COUNT(DISTINCT form_name) AS c FROM form_patterns WHERE node_path = 'Design'
+  `).get()?.c ?? 0;
+    const report = {
+        minedFormCount: totalForms,
+        catalogGaps: [],
+        subPatternGaps: [],
+        unusedCatalogEntries: [],
+        versionDrift: [],
+    };
+    const gapCounts = new Map();
+    const usedPatterns = new Set();
+    for (const row of designRows) {
+        const spec = resolvePatternExact(row.pattern);
+        if (!spec) {
+            gapCounts.set(row.pattern, (gapCounts.get(row.pattern) ?? 0) + row.forms);
+            continue;
+        }
+        usedPatterns.add(spec.xmlName.toLowerCase());
+        if (row.pattern_version && !spec.versions.includes(row.pattern_version)) {
+            report.versionDrift.push({ pattern: spec.xmlName, version: row.pattern_version, forms: row.forms });
+        }
+    }
+    report.catalogGaps = [...gapCounts.entries()]
+        .map(([pattern, forms]) => ({ pattern, forms }))
+        .sort((a, b) => b.forms - a.forms);
+    for (const row of subRows) {
+        const sp = resolveSubPattern(row.pattern);
+        if (!sp) {
+            report.subPatternGaps.push({ pattern: row.pattern, containers: row.containers });
+        }
+        else {
+            usedPatterns.add(sp.xmlName.toLowerCase());
+        }
+    }
+    report.subPatternGaps.sort((a, b) => b.containers - a.containers);
+    for (const spec of [...FORM_PATTERN_CATALOG.patterns, ...FORM_PATTERN_CATALOG.subPatterns]) {
+        if (!usedPatterns.has(spec.xmlName.toLowerCase())) {
+            report.unusedCatalogEntries.push(spec.xmlName);
+        }
+    }
+    return report;
+}
+export function formatCrossCheckReport(report) {
+    const lines = [];
+    lines.push(`Form pattern catalog cross-check (${report.minedFormCount} patterned forms mined):`);
+    if (report.catalogGaps.length === 0 && report.subPatternGaps.length === 0 && report.versionDrift.length === 0) {
+        lines.push('   OK  All mined patterns and versions are covered by the catalog.');
+    }
+    if (report.catalogGaps.length > 0) {
+        lines.push(`   [!] Patterns missing from the catalog (top ${Math.min(10, report.catalogGaps.length)}):`);
+        for (const gap of report.catalogGaps.slice(0, 10)) {
+            lines.push(`      - ${gap.pattern} (${gap.forms} forms)`);
+        }
+    }
+    if (report.subPatternGaps.length > 0) {
+        lines.push(`   [!] Sub-patterns missing from the catalog (top ${Math.min(10, report.subPatternGaps.length)}):`);
+        for (const gap of report.subPatternGaps.slice(0, 10)) {
+            lines.push(`      - ${gap.pattern} (${gap.containers} containers)`);
+        }
+    }
+    if (report.versionDrift.length > 0) {
+        lines.push('   [!] Version drift (mined version not in catalog -- update versions[] after verifying):');
+        for (const drift of report.versionDrift.slice(0, 10)) {
+            lines.push(`      - ${drift.pattern} v${drift.version} (${drift.forms} forms)`);
+        }
+    }
+    if (report.unusedCatalogEntries.length > 0) {
+        lines.push(`   [i] Catalog entries with zero mined usage (possible xmlName mismatch or unused area): ` +
+            report.unusedCatalogEntries.join(', '));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=crossCheck.js.map

package/dist/knowledge/formPatterns/crossCheck.js.map

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

package/dist/knowledge/formPatterns/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * D365FO Form Pattern Catalog — registry and lookups.
+ *
+ * Curated from Microsoft Learn pattern guideline docs and the reference forms
+ * in PackagesLocalDirectory; cross-checked against mined pattern usage from
+ * the symbol index (form_patterns table) once it is populated.
+ */
+import type { FormPatternCatalog, FormPatternSpec, SubPatternSpec } from './types.js';
+export * from './types.js';
+export declare const FORM_PATTERN_CATALOG: FormPatternCatalog;
+/**
+ * Resolve a top-level form pattern by id, xmlName, or free-text alias.
+ * Exact (case-insensitive) matches win; alias matching is a fallback.
+ */
+export declare function resolvePattern(name: string | undefined | null): FormPatternSpec | undefined;
+/**
+ * Strict resolution by id/xmlName only (case-insensitive) — used by the
+ * validator, where alias fuzziness would mask typos in <Pattern> values.
+ */
+export declare function resolvePatternExact(name: string | undefined | null): FormPatternSpec | undefined;
+/** Resolve a sub-pattern by id or xmlName (case-insensitive, exact only). */
+export declare function resolveSubPattern(name: string | undefined | null): SubPatternSpec | undefined;
+/**
+ * Sub-patterns applicable to a container control type, optionally restricted
+ * to those valid under a given top-level pattern.
+ */
+export declare function subPatternsFor(controlType: string, parentPatternId?: string): SubPatternSpec[];
+/** All known top-level pattern xmlNames (for tool descriptions/enums) */
+export declare function knownPatternNames(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge/formPatterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/formPatterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AA6BpB,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,oBAAoB,EAAE,kBAyClC,CAAC;AAsCF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,eAAe,GAAG,SAAS,CAc3F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,eAAe,GAAG,SAAS,CAGhG;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,CAG7F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,cAAc,EAAE,CAQlB;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}

package/dist/knowledge/formPatterns/index.js

@@ -0,0 +1,158 @@
+/**
+ * D365FO Form Pattern Catalog — registry and lookups.
+ *
+ * Curated from Microsoft Learn pattern guideline docs and the reference forms
+ * in PackagesLocalDirectory; cross-checked against mined pattern usage from
+ * the symbol index (form_patterns table) once it is populated.
+ */
+import { simpleList } from './catalog/topLevel/simpleList.js';
+import { simpleListDetailsListGrid, simpleListDetailsTree } from './catalog/topLevel/simpleListDetails.js';
+import { detailsMaster, detailsMasterTabs } from './catalog/topLevel/detailsMaster.js';
+import { detailsTransaction } from './catalog/topLevel/detailsTransaction.js';
+import { dialogBasic, dropDialog, dialogFastTabs, dialogTabs, dialogReadOnly, dialogDoubleTabs, dropDialogReadOnly } from './catalog/topLevel/dialog.js';
+import { tableOfContents, advancedSelection } from './catalog/topLevel/tableOfContents.js';
+import { lookupBasic, lookupGridOnly, lookupTab, lookupPreview } from './catalog/topLevel/lookup.js';
+import { listPage } from './catalog/topLevel/listPage.js';
+import { workspacePanorama, workspaceOperational, formPartSectionList, formPartSectionListDouble, hubPartChart, hubPartGrid, } from './catalog/topLevel/workspace.js';
+import { factBoxPatterns } from './catalog/topLevel/factBox.js';
+import { simpleDetailsPatterns, customPattern } from './catalog/topLevel/simpleDetails.js';
+import { taskPatterns } from './catalog/topLevel/task.js';
+import { wizard } from './catalog/topLevel/wizard.js';
+import { customFilterSubPatterns } from './catalog/subPatterns/customFilters.js';
+import { allFieldsSubPatterns } from './catalog/subPatterns/fields.js';
+import { panelSubPatterns } from './catalog/subPatterns/panels.js';
+import { toolbarSubPatterns } from './catalog/subPatterns/toolbar.js';
+import { workspaceSectionSubPatterns } from './catalog/subPatterns/workspaceSections.js';
+export * from './types.js';
+export const FORM_PATTERN_CATALOG = {
+    patterns: [
+        simpleList,
+        simpleListDetailsListGrid,
+        simpleListDetailsTree,
+        detailsMaster,
+        detailsMasterTabs,
+        detailsTransaction,
+        dialogBasic,
+        dropDialog,
+        dialogFastTabs,
+        dialogTabs,
+        dialogReadOnly,
+        dialogDoubleTabs,
+        dropDialogReadOnly,
+        tableOfContents,
+        advancedSelection,
+        lookupBasic,
+        lookupGridOnly,
+        lookupTab,
+        lookupPreview,
+        listPage,
+        workspacePanorama,
+        workspaceOperational,
+        formPartSectionList,
+        formPartSectionListDouble,
+        hubPartChart,
+        hubPartGrid,
+        ...factBoxPatterns,
+        ...simpleDetailsPatterns,
+        customPattern,
+        ...taskPatterns,
+        wizard,
+    ],
+    subPatterns: [
+        ...customFilterSubPatterns,
+        ...allFieldsSubPatterns,
+        ...panelSubPatterns,
+        ...toolbarSubPatterns,
+        ...workspaceSectionSubPatterns,
+    ],
+};
+const patternByKey = new Map();
+for (const p of FORM_PATTERN_CATALOG.patterns) {
+    patternByKey.set(p.id.toLowerCase(), p);
+    patternByKey.set(p.xmlName.toLowerCase(), p);
+    for (const alias of p.xmlAliases ?? [])
+        patternByKey.set(alias.toLowerCase(), p);
+}
+const subPatternByKey = new Map();
+for (const sp of FORM_PATTERN_CATALOG.subPatterns) {
+    subPatternByKey.set(sp.id.toLowerCase(), sp);
+    subPatternByKey.set(sp.xmlName.toLowerCase(), sp);
+    for (const alias of sp.xmlAliases ?? [])
+        subPatternByKey.set(alias.toLowerCase(), sp);
+}
+/**
+ * Free-text aliases → pattern id. Absorbs the historical
+ * FormPatternTemplates.normalizePattern() mappings so user/AI phrasing like
+ * "list", "master", "transaction" still resolves.
+ */
+const PATTERN_ALIASES = [
+    { test: (s) => s.includes('simplelist') && s.includes('detail'), id: 'SimpleListDetails' },
+    { test: (s) => s.includes('simplelist'), id: 'SimpleList' },
+    { test: (s) => s.includes('listpage'), id: 'ListPage' },
+    { test: (s) => s.includes('detail') && s.includes('master'), id: 'DetailsMaster' },
+    { test: (s) => s.includes('detail') && s.includes('transaction'), id: 'DetailsTransaction' },
+    { test: (s) => s.includes('dropdialog'), id: 'DropDialog' },
+    { test: (s) => s.includes('dialog'), id: 'Dialog' },
+    { test: (s) => s.includes('tableofcontents') || s.includes('toc') || s.includes('parameter'), id: 'TableOfContents' },
+    { test: (s) => s.includes('lookup'), id: 'Lookup' },
+    { test: (s) => s.includes('operational'), id: 'WorkspaceOperational' },
+    { test: (s) => s.includes('workspace') || s.includes('panorama'), id: 'Workspace' },
+    { test: (s) => s.includes('master'), id: 'DetailsMaster' },
+    { test: (s) => s.includes('transaction'), id: 'DetailsTransaction' },
+    { test: (s) => s.includes('list'), id: 'SimpleList' },
+];
+/**
+ * Resolve a top-level form pattern by id, xmlName, or free-text alias.
+ * Exact (case-insensitive) matches win; alias matching is a fallback.
+ */
+export function resolvePattern(name) {
+    if (!name)
+        return undefined;
+    const key = name.trim().toLowerCase();
+    const exact = patternByKey.get(key);
+    if (exact)
+        return exact;
+    const normalized = key.replace(/[^a-z]/g, '');
+    const byNormalized = patternByKey.get(normalized);
+    if (byNormalized)
+        return byNormalized;
+    for (const alias of PATTERN_ALIASES) {
+        if (alias.test(normalized))
+            return patternByKey.get(alias.id.toLowerCase());
+    }
+    return undefined;
+}
+/**
+ * Strict resolution by id/xmlName only (case-insensitive) — used by the
+ * validator, where alias fuzziness would mask typos in <Pattern> values.
+ */
+export function resolvePatternExact(name) {
+    if (!name)
+        return undefined;
+    return patternByKey.get(name.trim().toLowerCase());
+}
+/** Resolve a sub-pattern by id or xmlName (case-insensitive, exact only). */
+export function resolveSubPattern(name) {
+    if (!name)
+        return undefined;
+    return subPatternByKey.get(name.trim().toLowerCase());
+}
+/**
+ * Sub-patterns applicable to a container control type, optionally restricted
+ * to those valid under a given top-level pattern.
+ */
+export function subPatternsFor(controlType, parentPatternId) {
+    return FORM_PATTERN_CATALOG.subPatterns.filter((sp) => {
+        if (!sp.appliesToControlTypes.includes(controlType))
+            return false;
+        if (sp.parentPatterns && parentPatternId && !sp.parentPatterns.includes(parentPatternId)) {
+            return false;
+        }
+        return true;
+    });
+}
+/** All known top-level pattern xmlNames (for tool descriptions/enums) */
+export function knownPatternNames() {
+    return FORM_PATTERN_CATALOG.patterns.map((p) => p.xmlName);
+}
+//# sourceMappingURL=index.js.map

package/dist/knowledge/formPatterns/index.js.map

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