@xrmforge/devkit 0.4.0 → 0.5.1

package/dist/index.js

@@ -191,7 +191,26 @@ async function watch(config, options) {
 
 // src/scaffold/scaffold.ts
 import { mkdir as mkdir2, writeFile, readdir, access } from "fs/promises";
-import { join } from "path";
+import { join as join2 } from "path";
+
+// src/scaffold/template-loader.ts
+import { readFile } from "fs/promises";
+import { dirname as dirname2, join } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+var TEMPLATES_DIR = join(__dirname, "templates");
+async function loadTemplate(name, vars) {
+  const content = await readFile(join(TEMPLATES_DIR, name), "utf-8");
+  if (!vars || Object.keys(vars).length === 0) {
+    return content;
+  }
+  return Object.entries(vars).reduce(
+    (result, [key, value]) => result.replaceAll(`{{${key}}}`, value),
+    content
+  );
+}
+
+// src/scaffold/scaffold.ts
 async function scaffoldProject(config) {
   const { targetDir } = config;
   const filesCreated = [];
@@ -214,12 +233,12 @@ Use --force to scaffold anyway (existing files will be skipped).`,
     "tests/forms"
   ];
   for (const dir of dirs) {
-    await mkdir2(join(targetDir, dir), { recursive: true });
+    await mkdir2(join2(targetDir, dir), { recursive: true });
   }
-  const templates = generateTemplates(config);
+  const templates = await generateTemplates(config);
   for (const [relativePath, content] of templates) {
-    const absolutePath = join(targetDir, relativePath);
-    await mkdir2(join(absolutePath, ".."), { recursive: true });
+    const absolutePath = join2(targetDir, relativePath);
+    await mkdir2(join2(absolutePath, ".."), { recursive: true });
     if (config.force) {
       try {
         await access(absolutePath);
@@ -233,21 +252,22 @@ Use --force to scaffold anyway (existing files will be skipped).`,
   }
   return { filesCreated, warnings };
 }
-function generateTemplates(config) {
+async function generateTemplates(config) {
   const { projectName, prefix, namespace } = config;
   const lowerPrefix = prefix.toLowerCase();
+  const namespaceVars = { namespace };
   return [
     ["package.json", generatePackageJson(projectName)],
     ["tsconfig.json", generateTsConfig()],
     ["xrmforge.config.json", generateXrmForgeConfig(lowerPrefix, namespace)],
-    ["vitest.config.ts", generateVitestConfig()],
-    [".gitignore", generateGitIgnore()],
-    ["AGENT.md", generateAgentMd()],
-    ["src/forms/example-form.ts", generateExampleForm(namespace)],
+    ["vitest.config.ts", await loadTemplate("vitest.config.ts")],
+    [".gitignore", await loadTemplate("gitignore")],
+    ["AGENT.md", await loadTemplate("AGENT.md")],
+    ["src/forms/example-form.ts", await loadTemplate("example-form.ts", namespaceVars)],
     ["typings/.gitkeep", ""],
-    ["tests/forms/example-form.test.ts", generateExampleTest(namespace)],
-    [".github/workflows/ci.yml", generateGitHubActionsCI()],
-    ["azure-pipelines.yml", generateAzureDevOpsPipeline()]
+    ["tests/forms/example-form.test.ts", await loadTemplate("example-form.test.ts", namespaceVars)],
+    [".github/workflows/ci.yml", await loadTemplate("github-actions-ci.yml")],
+    ["azure-pipelines.yml", await loadTemplate("azure-pipelines.yml")]
   ];
 }
 function generatePackageJson(projectName) {
@@ -266,9 +286,9 @@ function generatePackageJson(projectName) {
     },
     devDependencies: {
       "@types/xrm": "^9.0.90",
-      "@xrmforge/cli": "^0.3.0",
-      "@xrmforge/testing": "^0.1.0",
-      "@xrmforge/formhelpers": "^0.1.0",
+      "@xrmforge/cli": "^0.4.3",
+      "@xrmforge/testing": "^0.2.0",
+      "@xrmforge/helpers": "^0.1.0",
       typescript: "^5.7.0",
       vitest: "^3.0.0"
     }
@@ -314,366 +334,6 @@ function generateXrmForgeConfig(prefix, namespace) {
   };
   return JSON.stringify(config, null, 2) + "\n";
 }
-function generateVitestConfig() {
-  return `import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: false,
-    include: ['tests/**/*.test.ts'],
-  },
-});
-`;
-}
-function generateGitIgnore() {
-  return `# Dependencies
-node_modules/
-
-# Build output
-dist/
-
-# XrmForge cache
-.xrmforge/
-
-# IDE
-.vscode/settings.json
-.idea/
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Logs
-*.log
-`;
-}
-function generateAgentMd() {
-  return `# XrmForge - AI Agent Instructions
-
-This file helps AI coding assistants write optimal Dynamics 365 form scripts.
-
-## Packages
-
-- \`@xrmforge/typegen\` - Generates typed declarations from Dataverse metadata
-- \`@xrmforge/testing\` - Type-safe form mocks: createFormMock(), fireOnChange()
-- \`@xrmforge/formhelpers\` - typedForm() proxy for direct field access
-- \`@xrmforge/devkit\` - esbuild IIFE bundles via xrmforge build
-- \`@xrmforge/eslint-plugin\` - D365-specific ESLint rules
-
-## Generated Types (typings/ directory)
-
-Run \`xrmforge generate\` to create:
-- \`typings/forms/{entity}.d.ts\` - Form interface + Fields/Tabs/Sections/Subgrids enums
-- \`typings/optionsets/{entity}.d.ts\` - OptionSet const enums
-- \`typings/entities/{entity}.d.ts\` - Entity interface + Fields enum
-- \`typings/entity-names.d.ts\` - EntityNames const enum
-
-## Rules: Always
-
-1. **Fields Enum** for getAttribute/getControl (not raw strings):
-   \`form.getAttribute(Fields.AccountName)\` not \`form.getAttribute("name")\`
-
-2. **OptionSet Enum** for comparisons (not magic numbers):
-   \`status === StatusCode.Active\` not \`status === 0\`
-
-3. **Cast formContext** to generated form interface:
-   \`const form = ctx.getFormContext() as AccountMainForm;\`
-
-4. **EntityNames Enum** for Web API calls:
-   \`Xrm.WebApi.retrieveRecord(EntityNames.Account, id)\`
-
-5. **parseLookup()** from @xrmforge/typegen/helpers for lookup values
-   IMPORTANT: Use \`@xrmforge/typegen/helpers\` (not \`@xrmforge/typegen\`) in browser code.
-   The main entry point pulls in Node.js dependencies that break esbuild bundles.
-
-6. **select()** from @xrmforge/typegen/helpers for $select queries
-
-7. **createFormMock()** from @xrmforge/testing for tests
-
-8. **Module exports** (not window/global assignments). esbuild globalName handles namespacing.
-
-9. **Tabs/Sections/Subgrids Enums** for UI access
-
-10. **Error handling** in all async event handlers (try/catch)
-
-## Rules: Never
-
-- Never \`getAttribute("raw_string")\` when Fields enum exists
-- Never magic numbers for OptionSet values
-- Never \`Xrm.Page\` (deprecated since D365 v9.0)
-- Never synchronous XMLHttpRequest
-- Never \`eval()\`
-- Never \`window.X = ...\` (use module exports)
-
-## Before/After Examples
-
-### Field Access
-\`\`\`typescript
-// BEFORE: formContext.getAttribute("name").getValue()
-// AFTER:
-import { AccountMainFormFieldsEnum as Fields } from '../typings/forms/account';
-const form = ctx.getFormContext() as AccountMainForm;
-form.getAttribute(Fields.AccountName).getValue();  // StringAttribute, typed
-\`\`\`
-
-### OptionSet Comparison
-\`\`\`typescript
-// BEFORE: if (status.getValue() === 595300002) { ... }
-// AFTER:
-import { StatusCode } from '../typings/optionsets/invoice';
-if (status.getValue() === StatusCode.Gebucht) { ... }
-\`\`\`
-
-### Testing
-\`\`\`typescript
-import { createFormMock } from '@xrmforge/testing';
-const mock = createFormMock<AccountMainForm, AccountMainFormMockValues>({
-  name: 'Test', statuscode: 0
-});
-onLoad(mock.executionContext);
-expect(mock.formContext.getControl('revenue').getVisible()).toBe(true);
-\`\`\`
-
-## File Structure
-
-\`\`\`
-src/forms/{entity}-form.ts       - Form scripts (one per entity)
-src/shared/{name}.ts             - Shared utilities
-typings/                         - Generated types (do not edit manually)
-tests/forms/{entity}.test.ts     - Tests
-xrmforge.config.json             - Build config
-\`\`\`
-
-## Pattern Recognition: Legacy to XrmForge
-
-When you see these patterns in legacy code, apply the XrmForge replacement:
-
-| Legacy Pattern | XrmForge Replacement |
-|---|---|
-| \`getAttribute("name")\` | \`getAttribute(Fields.Name)\` |
-| \`getControl("name")\` | \`getControl(Fields.Name)\` |
-| \`getValue() === 595300000\` | \`getValue() === OptionSets.StatusCode.Active\` |
-| \`Xrm.WebApi.retrieveRecord("account", id)\` | \`Xrm.WebApi.retrieveRecord(EntityNames.Account, id)\` |
-| \`"?$select=name,revenue"\` | \`select(Fields.Name, Fields.Revenue)\` (from typegen/helpers) |
-| \`value[0].id.replace("{","")...\` | \`parseLookup(form.getAttribute(Fields.X))\` (from typegen/helpers) |
-| \`Xrm.Page.getAttribute(...)\` | \`formContext.getAttribute(...)\` |
-| \`var formContext\` (global) | \`const form = ctx.getFormContext()\` (parameter) |
-| \`function form_OnLoad(ctx)\` | \`export function onLoad(ctx: Xrm.Events.EventContext)\` |
-| \`.then(success, error)\` | \`async/await with try/catch\` |
-
-### Creating OptionSet Enums from Legacy Magic Numbers
-
-When you find magic numbers like \`getValue() === 105710002\` in legacy code:
-1. Search the file for ALL numeric comparisons with getValue()
-2. Create a const enum in typings/optionsets/ with descriptive names
-3. Import and use the enum instead of the number
-
-Example:
-\`\`\`typescript
-// typings/optionsets/invoice.ts
-export const enum InvoiceStatusCode {
-  Neu = 1,
-  Versendet = 105710000,
-  Abgeschlossen = 105710001,
-  Gebucht = 105710002,
-}
-
-// In the form script:
-import { InvoiceStatusCode } from '../../typings/optionsets/invoice';
-if (status.getValue() === InvoiceStatusCode.Gebucht) { ... }
-\`\`\`
-
-## Testing with Global Xrm Mock
-
-Use \`setupXrmMock()\` from @xrmforge/testing to mock the global Xrm namespace:
-\`\`\`typescript
-import { createFormMock, setupXrmMock, teardownXrmMock } from '@xrmforge/testing';
-
-beforeEach(() => setupXrmMock());
-afterEach(() => teardownXrmMock());
-
-// Override specific WebApi methods:
-setupXrmMock({
-  webApiOverrides: {
-    retrieveMultipleRecords: async () => ({ entities: [{ name: 'Test' }] }),
-  },
-});
-\`\`\`
-
-## Build
-
-\`\`\`bash
-npx xrmforge build               # IIFE bundles for D365
-npx xrmforge build --watch        # Watch mode (~10ms rebuilds)
-\`\`\`
-
-## @types/xrm Pitfalls (known issues)
-
-When creating manual typings without \`xrmforge generate\`:
-
-1. **Form Interface:** Do NOT use \`interface extends Xrm.FormContext\` (getAttribute overload conflicts).
-   Use \`Omit\` pattern instead:
-   \`\`\`typescript
-   interface AccountMainForm extends Omit<Xrm.FormContext, 'getAttribute' | 'getControl'> {
-     getAttribute(name: Fields.AccountName): Xrm.Attributes.StringAttribute;
-     getAttribute(name: string): Xrm.Attributes.Attribute;
-     // ...
-   }
-   \`\`\`
-
-2. **AlertDialogResponse** does NOT exist in @types/xrm. Use \`Xrm.Async.PromiseLike<void>\`.
-
-3. **ConfirmDialogResponse** does NOT exist. Use \`Xrm.Navigation.ConfirmResult\`.
-
-4. **setNotification()** requires 2 arguments: (message, uniqueId).
-
-5. **openFile()** requires \`fileSize\` property in FileDetails.
-
-6. **const enum in .d.ts files** cannot be imported at runtime by test frameworks.
-   For manual typings, use regular \`enum\` in \`.ts\` files (not \`.d.ts\`).
-
-## Full Migration Guide
-
-See: https://www.npmjs.com/package/@xrmforge/typegen (MIGRATION.md)
-`;
-}
-function generateExampleForm(namespace) {
-  return `/**
- * Example Form Script for Dynamics 365.
- *
- * Register in D365 as: ${namespace}.Example.onLoad
- *
- * Replace this with your actual form logic.
- */
-
-/**
- * Called when the form loads.
- */
-export function onLoad(executionContext: Xrm.Events.EventContext): void {
-  const formContext = executionContext.getFormContext();
-
-  // Example: show a notification on the form
-  formContext.ui.setFormNotification(
-    'Form loaded successfully',
-    'INFO',
-    'example-notification',
-  );
-
-  // Example: read a field value
-  const nameAttr = formContext.getAttribute('name');
-  if (nameAttr) {
-    const value = nameAttr.getValue();
-    console.log('Name field value:', value);
-  }
-}
-
-/**
- * Called when the form is saved.
- */
-export function onSave(executionContext: Xrm.Events.EventContext): void {
-  const formContext = executionContext.getFormContext();
-
-  // Clear the notification on save
-  formContext.ui.clearFormNotification('example-notification');
-}
-`;
-}
-function generateExampleTest(namespace) {
-  return `import { describe, it, expect } from 'vitest';
-
-/**
- * Example test for the form script.
- *
- * Uses @xrmforge/testing for type-safe mocking once you have
- * generated types. For now, this is a placeholder.
- */
-describe('${namespace}.Example', () => {
-  it('should export onLoad function', async () => {
-    const mod = await import('../../src/forms/example-form.js');
-    expect(typeof mod.onLoad).toBe('function');
-  });
-
-  it('should export onSave function', async () => {
-    const mod = await import('../../src/forms/example-form.js');
-    expect(typeof mod.onSave).toBe('function');
-  });
-});
-`;
-}
-function generateGitHubActionsCI() {
-  return `name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - run: npm ci
-
-      - name: Generate types from Dataverse
-        run: npx xrmforge generate --from-config
-        env:
-          XRMFORGE_CLIENT_ID: \${{ secrets.XRMFORGE_CLIENT_ID }}
-          XRMFORGE_CLIENT_SECRET: \${{ secrets.XRMFORGE_CLIENT_SECRET }}
-          XRMFORGE_TENANT_ID: \${{ secrets.XRMFORGE_TENANT_ID }}
-
-      - name: Type check
-        run: npx tsc --noEmit
-
-      - name: Test
-        run: npx vitest run
-
-      - name: Build WebResources
-        run: npx xrmforge build
-`;
-}
-function generateAzureDevOpsPipeline() {
-  return `trigger:
-  branches:
-    include:
-      - main
-
-pool:
-  vmImage: 'ubuntu-latest'
-
-steps:
-  - task: NodeTool@0
-    inputs:
-      versionSpec: '20.x'
-    displayName: 'Install Node.js'
-
-  - script: npm ci
-    displayName: 'Install dependencies'
-
-  - script: npx xrmforge generate --from-config
-    displayName: 'Generate types from Dataverse'
-    env:
-      XRMFORGE_CLIENT_ID: $(XRMFORGE_CLIENT_ID)
-      XRMFORGE_CLIENT_SECRET: $(XRMFORGE_CLIENT_SECRET)
-      XRMFORGE_TENANT_ID: $(XRMFORGE_TENANT_ID)
-
-  - script: npx tsc --noEmit
-    displayName: 'Type check'
-
-  - script: npx vitest run
-    displayName: 'Test'
-
-  - script: npx xrmforge build
-    displayName: 'Build WebResources'
-`;
-}
 export {
   BuildError,
   BuildErrorCode,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/builder/esbuild-builder.ts","../src/scaffold/scaffold.ts"],"sourcesContent":["/**\n * @xrmforge/devkit - Build Error Types\n *\n * Structured error types for build operations.\n */\n\nexport enum BuildErrorCode {\n  /** Build configuration is invalid or missing required fields */\n  CONFIG_INVALID = 'BUILD_6001',\n  /** Entry point file not found on disk */\n  ENTRY_NOT_FOUND = 'BUILD_6002',\n  /** esbuild compilation failed (syntax errors, missing imports) */\n  BUILD_FAILED = 'BUILD_6003',\n  /** Error in watch mode */\n  WATCH_ERROR = 'BUILD_6004',\n}\n\n/**\n * Error class for build operations.\n * Carries a machine-readable code and optional context for debugging.\n */\nexport class BuildError extends Error {\n  public readonly code: BuildErrorCode;\n  public readonly context: Record<string, unknown>;\n\n  constructor(code: BuildErrorCode, message: string, context: Record<string, unknown> = {}) {\n    super(`[${code}] ${message}`);\n    this.name = 'BuildError';\n    this.code = code;\n    this.context = context;\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, BuildError);\n    }\n  }\n}\n","/**\n * @xrmforge/devkit - Build Configuration\n *\n * Types and validation for the `build` section in xrmforge.config.json.\n */\n\nimport { BuildError, BuildErrorCode } from './errors.js';\n\n/** A single build entry (one WebResource) */\nexport interface BuildEntry {\n  /** Relative path to the TypeScript source file */\n  input: string;\n  /** Global namespace for D365 form event binding (e.g. \"Contoso.Account\") */\n  namespace: string;\n  /** Optional output filename relative to outDir (defaults to entry key + \".js\") */\n  out?: string;\n}\n\n/** Build configuration for WebResource bundling */\nexport interface BuildConfig {\n  /** Bundler to use (currently only \"esbuild\") */\n  bundler?: 'esbuild';\n  /** Named build entries: key = entry name, value = entry config */\n  entries: Record<string, BuildEntry>;\n  /** Output directory for built bundles (default: \"./dist\") */\n  outDir?: string;\n  /** JavaScript target version (default: \"es2020\") */\n  target?: string;\n  /** Generate source maps (default: true) */\n  sourcemap?: boolean;\n  /** Minify output (default: false) */\n  minify?: boolean;\n  /** Additional modules to exclude from bundling */\n  external?: string[];\n}\n\n/** Fully resolved build config with all defaults applied */\nexport interface ResolvedBuildConfig {\n  bundler: 'esbuild';\n  entries: Record<string, BuildEntry>;\n  outDir: string;\n  target: string;\n  sourcemap: boolean;\n  minify: boolean;\n  external: string[];\n}\n\n/**\n * Validate a raw build config object.\n * Throws BuildError with CONFIG_INVALID if any required field is missing or invalid.\n */\nexport function validateBuildConfig(raw: unknown): BuildConfig {\n  if (!raw || typeof raw !== 'object') {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration must be an object.',\n    );\n  }\n\n  const config = raw as Record<string, unknown>;\n\n  // entries: required, non-empty object\n  if (!config['entries'] || typeof config['entries'] !== 'object' || Array.isArray(config['entries'])) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration requires an \"entries\" object with at least one entry.',\n    );\n  }\n\n  const entries = config['entries'] as Record<string, unknown>;\n  const entryNames = Object.keys(entries);\n\n  if (entryNames.length === 0) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration requires at least one entry in \"entries\".',\n    );\n  }\n\n  for (const name of entryNames) {\n    const entry = entries[name] as Record<string, unknown> | undefined;\n\n    if (!entry || typeof entry !== 'object') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" must be an object with \"input\" and \"namespace\".`,\n        { entry: name },\n      );\n    }\n\n    if (!entry['input'] || typeof entry['input'] !== 'string') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" requires an \"input\" field (path to .ts source file).`,\n        { entry: name },\n      );\n    }\n\n    if (!entry['namespace'] || typeof entry['namespace'] !== 'string') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" requires a \"namespace\" field (e.g. \"Contoso.Account\").`,\n        { entry: name },\n      );\n    }\n  }\n\n  // bundler: optional, must be \"esbuild\" if set\n  if (config['bundler'] !== undefined && config['bundler'] !== 'esbuild') {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      `Unsupported bundler: \"${String(config['bundler'])}\". Currently only \"esbuild\" is supported.`,\n      { bundler: config['bundler'] },\n    );\n  }\n\n  return config as unknown as BuildConfig;\n}\n\n/**\n * Apply default values to a validated build config.\n */\nexport function resolveBuildConfig(config: BuildConfig): ResolvedBuildConfig {\n  return {\n    bundler: config.bundler ?? 'esbuild',\n    entries: config.entries,\n    outDir: config.outDir ?? './dist',\n    target: config.target ?? 'es2020',\n    sourcemap: config.sourcemap ?? true,\n    minify: config.minify ?? false,\n    external: config.external ?? [],\n  };\n}\n","/**\n * @xrmforge/devkit - esbuild Builder\n *\n * Builds D365 WebResources as IIFE bundles with named globals.\n * Abstracts esbuild so users never write esbuild config.\n */\n\nimport * as esbuild from 'esbuild';\nimport { stat, mkdir } from 'node:fs/promises';\nimport { resolve, dirname } from 'node:path';\nimport type { BuildConfig } from '../config.js';\nimport { resolveBuildConfig } from '../config.js';\nimport { BuildError, BuildErrorCode } from '../errors.js';\nimport type { BuildResult, BuildResultEntry } from './types.js';\n\n/**\n * Build all entries defined in the config as IIFE bundles.\n *\n * @param config - Validated build configuration\n * @param cwd - Working directory for resolving relative paths (defaults to process.cwd())\n * @returns Build result with per-entry details\n */\nexport async function build(config: BuildConfig, cwd?: string): Promise<BuildResult> {\n  const startTime = Date.now();\n  const resolved = resolveBuildConfig(config);\n  const basedir = cwd ?? process.cwd();\n  const outDir = resolve(basedir, resolved.outDir);\n\n  // Ensure output directory exists\n  await mkdir(outDir, { recursive: true });\n\n  const entryNames = Object.keys(resolved.entries);\n  const results: BuildResultEntry[] = [];\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Build all entries in parallel\n  const settled = await Promise.allSettled(\n    entryNames.map(async (name) => {\n      const entry = resolved.entries[name]!;\n      const entryStart = Date.now();\n      const outFile = resolve(outDir, entry.out ?? `${name}.js`);\n\n      // Ensure subdirectory exists for custom out paths\n      await mkdir(dirname(outFile), { recursive: true });\n\n      const buildOptions: esbuild.BuildOptions = {\n        entryPoints: [resolve(basedir, entry.input)],\n        bundle: true,\n        format: 'iife',\n        globalName: entry.namespace,\n        outfile: outFile,\n        target: [resolved.target],\n        minify: resolved.minify,\n        sourcemap: resolved.sourcemap,\n        treeShaking: true,\n        logLevel: 'silent',\n        external: resolved.external,\n      };\n\n      const result = await esbuild.build(buildOptions);\n\n      // Collect esbuild warnings\n      for (const w of result.warnings) {\n        warnings.push(`[${name}] ${w.text}`);\n      }\n\n      // Get output file size\n      const stats = await stat(outFile);\n\n      return {\n        name,\n        outFile,\n        sizeBytes: stats.size,\n        durationMs: Date.now() - entryStart,\n      } satisfies BuildResultEntry;\n    }),\n  );\n\n  for (let i = 0; i < settled.length; i++) {\n    const outcome = settled[i]!;\n    const name = entryNames[i]!;\n\n    if (outcome.status === 'fulfilled') {\n      results.push(outcome.value);\n    } else {\n      const errorMsg = outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason);\n      // Distinguish \"file not found\" from other build errors\n      if (errorMsg.includes('Could not resolve') || errorMsg.includes('ENOENT')) {\n        errors.push(`[${name}] ${new BuildError(BuildErrorCode.ENTRY_NOT_FOUND, errorMsg, { entry: name }).message}`);\n      } else {\n        errors.push(`[${name}] ${new BuildError(BuildErrorCode.BUILD_FAILED, errorMsg, { entry: name }).message}`);\n      }\n    }\n  }\n\n  return {\n    entries: results,\n    totalDurationMs: Date.now() - startTime,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Start watch mode for all entries.\n * Returns a dispose function to stop watching.\n *\n * @param config - Validated build configuration\n * @param options - Watch options\n * @returns Object with dispose() to stop watching\n */\nexport async function watch(\n  config: BuildConfig,\n  options?: {\n    cwd?: string;\n    onRebuild?: (result: BuildResult) => void;\n  },\n): Promise<{ dispose: () => Promise<void> }> {\n  const resolved = resolveBuildConfig(config);\n  const basedir = options?.cwd ?? process.cwd();\n  const outDir = resolve(basedir, resolved.outDir);\n\n  await mkdir(outDir, { recursive: true });\n\n  const contexts: esbuild.BuildContext[] = [];\n\n  for (const [name, entry] of Object.entries(resolved.entries)) {\n    const outFile = resolve(outDir, entry.out ?? `${name}.js`);\n    await mkdir(dirname(outFile), { recursive: true });\n\n    const ctx = await esbuild.context({\n      entryPoints: [resolve(basedir, entry.input)],\n      bundle: true,\n      format: 'iife',\n      globalName: entry.namespace,\n      outfile: outFile,\n      target: [resolved.target],\n      minify: resolved.minify,\n      sourcemap: resolved.sourcemap,\n      treeShaking: true,\n      logLevel: 'silent',\n      external: resolved.external,\n    });\n\n    contexts.push(ctx);\n    await ctx.watch();\n  }\n\n  return {\n    dispose: async () => {\n      for (const ctx of contexts) {\n        await ctx.dispose();\n      }\n    },\n  };\n}\n","/**\n * @xrmforge/devkit - Project Scaffolding\n *\n * Generates a complete D365 form scripting project from templates.\n */\n\nimport { mkdir, writeFile, readdir, access } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { ScaffoldConfig, ScaffoldResult } from './types.js';\nimport { BuildError, BuildErrorCode } from '../errors.js';\n\n/**\n * Scaffold a new D365 form scripting project.\n *\n * Creates a complete project structure with package.json, tsconfig,\n * xrmforge.config.json, example form script, and test file.\n *\n * @param config - Scaffold configuration\n * @returns List of created files and any warnings\n * @throws {BuildError} if target directory is not empty (unless files are only dotfiles)\n */\nexport async function scaffoldProject(config: ScaffoldConfig): Promise<ScaffoldResult> {\n  const { targetDir } = config;\n  const filesCreated: string[] = [];\n  const warnings: string[] = [];\n\n  // Ensure target directory exists\n  await mkdir(targetDir, { recursive: true });\n\n  // Check if directory is empty (ignore dotfiles and node_modules)\n  const existing = await readdir(targetDir);\n  const nonDotFiles = existing.filter((f) => !f.startsWith('.') && f !== 'node_modules');\n  if (nonDotFiles.length > 0 && !config.force) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      `Target directory is not empty: ${targetDir}\\n` +\n        `Found: ${nonDotFiles.slice(0, 5).join(', ')}${nonDotFiles.length > 5 ? '...' : ''}\\n` +\n        `Use --force to scaffold anyway (existing files will be skipped).`,\n      { targetDir, existingFiles: nonDotFiles },\n    );\n  }\n\n  // Create directory structure\n  const dirs = [\n    'src/forms',\n    'typings',\n    'tests/forms',\n  ];\n\n  for (const dir of dirs) {\n    await mkdir(join(targetDir, dir), { recursive: true });\n  }\n\n  // Generate and write all template files\n  const templates = generateTemplates(config);\n\n  for (const [relativePath, content] of templates) {\n    const absolutePath = join(targetDir, relativePath);\n    await mkdir(join(absolutePath, '..'), { recursive: true });\n\n    // In force mode: skip files that already exist\n    if (config.force) {\n      try {\n        await access(absolutePath);\n        warnings.push(`Skipped ${relativePath} (already exists)`);\n        continue;\n      } catch {\n        // File doesn't exist, proceed with write\n      }\n    }\n\n    await writeFile(absolutePath, content, 'utf-8');\n    filesCreated.push(relativePath);\n  }\n\n  return { filesCreated, warnings };\n}\n\n/**\n * Generate all template file contents.\n * Returns an array of [relativePath, content] tuples.\n */\nfunction generateTemplates(config: ScaffoldConfig): Array<[string, string]> {\n  const { projectName, prefix, namespace } = config;\n  const lowerPrefix = prefix.toLowerCase();\n\n  return [\n    ['package.json', generatePackageJson(projectName)],\n    ['tsconfig.json', generateTsConfig()],\n    ['xrmforge.config.json', generateXrmForgeConfig(lowerPrefix, namespace)],\n    ['vitest.config.ts', generateVitestConfig()],\n    ['.gitignore', generateGitIgnore()],\n    ['AGENT.md', generateAgentMd()],\n    ['src/forms/example-form.ts', generateExampleForm(namespace)],\n    ['typings/.gitkeep', ''],\n    ['tests/forms/example-form.test.ts', generateExampleTest(namespace)],\n    ['.github/workflows/ci.yml', generateGitHubActionsCI()],\n    ['azure-pipelines.yml', generateAzureDevOpsPipeline()],\n  ];\n}\n\nfunction generatePackageJson(projectName: string): string {\n  const pkg = {\n    name: projectName,\n    version: '0.1.0',\n    private: true,\n    type: 'module',\n    scripts: {\n      generate: 'xrmforge generate',\n      typecheck: 'tsc --noEmit',\n      build: 'xrmforge build',\n      watch: 'xrmforge build --watch',\n      test: 'vitest run',\n      'test:watch': 'vitest',\n    },\n    devDependencies: {\n      '@types/xrm': '^9.0.90',\n      '@xrmforge/cli': '^0.3.0',\n      '@xrmforge/testing': '^0.1.0',\n      '@xrmforge/formhelpers': '^0.1.0',\n      typescript: '^5.7.0',\n      vitest: '^3.0.0',\n    },\n  };\n  return JSON.stringify(pkg, null, 2) + '\\n';\n}\n\nfunction generateTsConfig(): string {\n  const config = {\n    compilerOptions: {\n      target: 'ES2020',\n      module: 'ESNext',\n      moduleResolution: 'bundler',\n      lib: ['ES2020', 'DOM'],\n      types: ['xrm'],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: false,\n      esModuleInterop: true,\n    },\n    include: [\n      'src/**/*.ts',\n      'typings/**/*.d.ts',\n      'typings/**/*.ts',\n    ],\n  };\n  return JSON.stringify(config, null, 2) + '\\n';\n}\n\nfunction generateXrmForgeConfig(prefix: string, namespace: string): string {\n  const config = {\n    build: {\n      outDir: `./dist/${prefix}_/JS`,\n      target: 'es2020',\n      sourcemap: true,\n      minify: true,\n      entries: {\n        example_form: {\n          input: './src/forms/example-form.ts',\n          namespace: `${namespace}.Example`,\n          out: 'Example/OnLoad.js',\n        },\n      },\n    },\n  };\n  return JSON.stringify(config, null, 2) + '\\n';\n}\n\nfunction generateVitestConfig(): string {\n  return `import { defineConfig } from 'vitest/config';\n\nexport default defineConfig({\n  test: {\n    globals: false,\n    include: ['tests/**/*.test.ts'],\n  },\n});\n`;\n}\n\nfunction generateGitIgnore(): string {\n  return `# Dependencies\nnode_modules/\n\n# Build output\ndist/\n\n# XrmForge cache\n.xrmforge/\n\n# IDE\n.vscode/settings.json\n.idea/\n\n# OS\n.DS_Store\nThumbs.db\n\n# Logs\n*.log\n`;\n}\n\nfunction generateAgentMd(): string {\n  return `# XrmForge - AI Agent Instructions\n\nThis file helps AI coding assistants write optimal Dynamics 365 form scripts.\n\n## Packages\n\n- \\`@xrmforge/typegen\\` - Generates typed declarations from Dataverse metadata\n- \\`@xrmforge/testing\\` - Type-safe form mocks: createFormMock(), fireOnChange()\n- \\`@xrmforge/formhelpers\\` - typedForm() proxy for direct field access\n- \\`@xrmforge/devkit\\` - esbuild IIFE bundles via xrmforge build\n- \\`@xrmforge/eslint-plugin\\` - D365-specific ESLint rules\n\n## Generated Types (typings/ directory)\n\nRun \\`xrmforge generate\\` to create:\n- \\`typings/forms/{entity}.d.ts\\` - Form interface + Fields/Tabs/Sections/Subgrids enums\n- \\`typings/optionsets/{entity}.d.ts\\` - OptionSet const enums\n- \\`typings/entities/{entity}.d.ts\\` - Entity interface + Fields enum\n- \\`typings/entity-names.d.ts\\` - EntityNames const enum\n\n## Rules: Always\n\n1. **Fields Enum** for getAttribute/getControl (not raw strings):\n   \\`form.getAttribute(Fields.AccountName)\\` not \\`form.getAttribute(\"name\")\\`\n\n2. **OptionSet Enum** for comparisons (not magic numbers):\n   \\`status === StatusCode.Active\\` not \\`status === 0\\`\n\n3. **Cast formContext** to generated form interface:\n   \\`const form = ctx.getFormContext() as AccountMainForm;\\`\n\n4. **EntityNames Enum** for Web API calls:\n   \\`Xrm.WebApi.retrieveRecord(EntityNames.Account, id)\\`\n\n5. **parseLookup()** from @xrmforge/typegen/helpers for lookup values\n   IMPORTANT: Use \\`@xrmforge/typegen/helpers\\` (not \\`@xrmforge/typegen\\`) in browser code.\n   The main entry point pulls in Node.js dependencies that break esbuild bundles.\n\n6. **select()** from @xrmforge/typegen/helpers for $select queries\n\n7. **createFormMock()** from @xrmforge/testing for tests\n\n8. **Module exports** (not window/global assignments). esbuild globalName handles namespacing.\n\n9. **Tabs/Sections/Subgrids Enums** for UI access\n\n10. **Error handling** in all async event handlers (try/catch)\n\n## Rules: Never\n\n- Never \\`getAttribute(\"raw_string\")\\` when Fields enum exists\n- Never magic numbers for OptionSet values\n- Never \\`Xrm.Page\\` (deprecated since D365 v9.0)\n- Never synchronous XMLHttpRequest\n- Never \\`eval()\\`\n- Never \\`window.X = ...\\` (use module exports)\n\n## Before/After Examples\n\n### Field Access\n\\`\\`\\`typescript\n// BEFORE: formContext.getAttribute(\"name\").getValue()\n// AFTER:\nimport { AccountMainFormFieldsEnum as Fields } from '../typings/forms/account';\nconst form = ctx.getFormContext() as AccountMainForm;\nform.getAttribute(Fields.AccountName).getValue();  // StringAttribute, typed\n\\`\\`\\`\n\n### OptionSet Comparison\n\\`\\`\\`typescript\n// BEFORE: if (status.getValue() === 595300002) { ... }\n// AFTER:\nimport { StatusCode } from '../typings/optionsets/invoice';\nif (status.getValue() === StatusCode.Gebucht) { ... }\n\\`\\`\\`\n\n### Testing\n\\`\\`\\`typescript\nimport { createFormMock } from '@xrmforge/testing';\nconst mock = createFormMock<AccountMainForm, AccountMainFormMockValues>({\n  name: 'Test', statuscode: 0\n});\nonLoad(mock.executionContext);\nexpect(mock.formContext.getControl('revenue').getVisible()).toBe(true);\n\\`\\`\\`\n\n## File Structure\n\n\\`\\`\\`\nsrc/forms/{entity}-form.ts       - Form scripts (one per entity)\nsrc/shared/{name}.ts             - Shared utilities\ntypings/                         - Generated types (do not edit manually)\ntests/forms/{entity}.test.ts     - Tests\nxrmforge.config.json             - Build config\n\\`\\`\\`\n\n## Pattern Recognition: Legacy to XrmForge\n\nWhen you see these patterns in legacy code, apply the XrmForge replacement:\n\n| Legacy Pattern | XrmForge Replacement |\n|---|---|\n| \\`getAttribute(\"name\")\\` | \\`getAttribute(Fields.Name)\\` |\n| \\`getControl(\"name\")\\` | \\`getControl(Fields.Name)\\` |\n| \\`getValue() === 595300000\\` | \\`getValue() === OptionSets.StatusCode.Active\\` |\n| \\`Xrm.WebApi.retrieveRecord(\"account\", id)\\` | \\`Xrm.WebApi.retrieveRecord(EntityNames.Account, id)\\` |\n| \\`\"?$select=name,revenue\"\\` | \\`select(Fields.Name, Fields.Revenue)\\` (from typegen/helpers) |\n| \\`value[0].id.replace(\"{\",\"\")...\\` | \\`parseLookup(form.getAttribute(Fields.X))\\` (from typegen/helpers) |\n| \\`Xrm.Page.getAttribute(...)\\` | \\`formContext.getAttribute(...)\\` |\n| \\`var formContext\\` (global) | \\`const form = ctx.getFormContext()\\` (parameter) |\n| \\`function form_OnLoad(ctx)\\` | \\`export function onLoad(ctx: Xrm.Events.EventContext)\\` |\n| \\`.then(success, error)\\` | \\`async/await with try/catch\\` |\n\n### Creating OptionSet Enums from Legacy Magic Numbers\n\nWhen you find magic numbers like \\`getValue() === 105710002\\` in legacy code:\n1. Search the file for ALL numeric comparisons with getValue()\n2. Create a const enum in typings/optionsets/ with descriptive names\n3. Import and use the enum instead of the number\n\nExample:\n\\`\\`\\`typescript\n// typings/optionsets/invoice.ts\nexport const enum InvoiceStatusCode {\n  Neu = 1,\n  Versendet = 105710000,\n  Abgeschlossen = 105710001,\n  Gebucht = 105710002,\n}\n\n// In the form script:\nimport { InvoiceStatusCode } from '../../typings/optionsets/invoice';\nif (status.getValue() === InvoiceStatusCode.Gebucht) { ... }\n\\`\\`\\`\n\n## Testing with Global Xrm Mock\n\nUse \\`setupXrmMock()\\` from @xrmforge/testing to mock the global Xrm namespace:\n\\`\\`\\`typescript\nimport { createFormMock, setupXrmMock, teardownXrmMock } from '@xrmforge/testing';\n\nbeforeEach(() => setupXrmMock());\nafterEach(() => teardownXrmMock());\n\n// Override specific WebApi methods:\nsetupXrmMock({\n  webApiOverrides: {\n    retrieveMultipleRecords: async () => ({ entities: [{ name: 'Test' }] }),\n  },\n});\n\\`\\`\\`\n\n## Build\n\n\\`\\`\\`bash\nnpx xrmforge build               # IIFE bundles for D365\nnpx xrmforge build --watch        # Watch mode (~10ms rebuilds)\n\\`\\`\\`\n\n## @types/xrm Pitfalls (known issues)\n\nWhen creating manual typings without \\`xrmforge generate\\`:\n\n1. **Form Interface:** Do NOT use \\`interface extends Xrm.FormContext\\` (getAttribute overload conflicts).\n   Use \\`Omit\\` pattern instead:\n   \\`\\`\\`typescript\n   interface AccountMainForm extends Omit<Xrm.FormContext, 'getAttribute' | 'getControl'> {\n     getAttribute(name: Fields.AccountName): Xrm.Attributes.StringAttribute;\n     getAttribute(name: string): Xrm.Attributes.Attribute;\n     // ...\n   }\n   \\`\\`\\`\n\n2. **AlertDialogResponse** does NOT exist in @types/xrm. Use \\`Xrm.Async.PromiseLike<void>\\`.\n\n3. **ConfirmDialogResponse** does NOT exist. Use \\`Xrm.Navigation.ConfirmResult\\`.\n\n4. **setNotification()** requires 2 arguments: (message, uniqueId).\n\n5. **openFile()** requires \\`fileSize\\` property in FileDetails.\n\n6. **const enum in .d.ts files** cannot be imported at runtime by test frameworks.\n   For manual typings, use regular \\`enum\\` in \\`.ts\\` files (not \\`.d.ts\\`).\n\n## Full Migration Guide\n\nSee: https://www.npmjs.com/package/@xrmforge/typegen (MIGRATION.md)\n`;\n}\n\nfunction generateExampleForm(namespace: string): string {\n  return `/**\n * Example Form Script for Dynamics 365.\n *\n * Register in D365 as: ${namespace}.Example.onLoad\n *\n * Replace this with your actual form logic.\n */\n\n/**\n * Called when the form loads.\n */\nexport function onLoad(executionContext: Xrm.Events.EventContext): void {\n  const formContext = executionContext.getFormContext();\n\n  // Example: show a notification on the form\n  formContext.ui.setFormNotification(\n    'Form loaded successfully',\n    'INFO',\n    'example-notification',\n  );\n\n  // Example: read a field value\n  const nameAttr = formContext.getAttribute('name');\n  if (nameAttr) {\n    const value = nameAttr.getValue();\n    console.log('Name field value:', value);\n  }\n}\n\n/**\n * Called when the form is saved.\n */\nexport function onSave(executionContext: Xrm.Events.EventContext): void {\n  const formContext = executionContext.getFormContext();\n\n  // Clear the notification on save\n  formContext.ui.clearFormNotification('example-notification');\n}\n`;\n}\n\nfunction generateExampleTest(namespace: string): string {\n  return `import { describe, it, expect } from 'vitest';\n\n/**\n * Example test for the form script.\n *\n * Uses @xrmforge/testing for type-safe mocking once you have\n * generated types. For now, this is a placeholder.\n */\ndescribe('${namespace}.Example', () => {\n  it('should export onLoad function', async () => {\n    const mod = await import('../../src/forms/example-form.js');\n    expect(typeof mod.onLoad).toBe('function');\n  });\n\n  it('should export onSave function', async () => {\n    const mod = await import('../../src/forms/example-form.js');\n    expect(typeof mod.onSave).toBe('function');\n  });\n});\n`;\n}\n\nfunction generateGitHubActionsCI(): string {\n  return `name: CI\n\non:\n  push:\n    branches: [main]\n  pull_request:\n    branches: [main]\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n\n    steps:\n      - uses: actions/checkout@v4\n\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 20\n\n      - run: npm ci\n\n      - name: Generate types from Dataverse\n        run: npx xrmforge generate --from-config\n        env:\n          XRMFORGE_CLIENT_ID: \\${{ secrets.XRMFORGE_CLIENT_ID }}\n          XRMFORGE_CLIENT_SECRET: \\${{ secrets.XRMFORGE_CLIENT_SECRET }}\n          XRMFORGE_TENANT_ID: \\${{ secrets.XRMFORGE_TENANT_ID }}\n\n      - name: Type check\n        run: npx tsc --noEmit\n\n      - name: Test\n        run: npx vitest run\n\n      - name: Build WebResources\n        run: npx xrmforge build\n`;\n}\n\nfunction generateAzureDevOpsPipeline(): string {\n  return `trigger:\n  branches:\n    include:\n      - main\n\npool:\n  vmImage: 'ubuntu-latest'\n\nsteps:\n  - task: NodeTool@0\n    inputs:\n      versionSpec: '20.x'\n    displayName: 'Install Node.js'\n\n  - script: npm ci\n    displayName: 'Install dependencies'\n\n  - script: npx xrmforge generate --from-config\n    displayName: 'Generate types from Dataverse'\n    env:\n      XRMFORGE_CLIENT_ID: \\$(XRMFORGE_CLIENT_ID)\n      XRMFORGE_CLIENT_SECRET: \\$(XRMFORGE_CLIENT_SECRET)\n      XRMFORGE_TENANT_ID: \\$(XRMFORGE_TENANT_ID)\n\n  - script: npx tsc --noEmit\n    displayName: 'Type check'\n\n  - script: npx vitest run\n    displayName: 'Test'\n\n  - script: npx xrmforge build\n    displayName: 'Build WebResources'\n`;\n}\n"],"mappings":"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","names":["BuildErrorCode","context","build","mkdir","mkdir"]}
+{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/builder/esbuild-builder.ts","../src/scaffold/scaffold.ts","../src/scaffold/template-loader.ts"],"sourcesContent":["/**\n * @xrmforge/devkit - Build Error Types\n *\n * Structured error types for build operations.\n */\n\nexport enum BuildErrorCode {\n  /** Build configuration is invalid or missing required fields */\n  CONFIG_INVALID = 'BUILD_6001',\n  /** Entry point file not found on disk */\n  ENTRY_NOT_FOUND = 'BUILD_6002',\n  /** esbuild compilation failed (syntax errors, missing imports) */\n  BUILD_FAILED = 'BUILD_6003',\n  /** Error in watch mode */\n  WATCH_ERROR = 'BUILD_6004',\n}\n\n/**\n * Error class for build operations.\n * Carries a machine-readable code and optional context for debugging.\n */\nexport class BuildError extends Error {\n  public readonly code: BuildErrorCode;\n  public readonly context: Record<string, unknown>;\n\n  constructor(code: BuildErrorCode, message: string, context: Record<string, unknown> = {}) {\n    super(`[${code}] ${message}`);\n    this.name = 'BuildError';\n    this.code = code;\n    this.context = context;\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, BuildError);\n    }\n  }\n}\n","/**\n * @xrmforge/devkit - Build Configuration\n *\n * Types and validation for the `build` section in xrmforge.config.json.\n */\n\nimport { BuildError, BuildErrorCode } from './errors.js';\n\n/** A single build entry (one WebResource) */\nexport interface BuildEntry {\n  /** Relative path to the TypeScript source file */\n  input: string;\n  /** Global namespace for D365 form event binding (e.g. \"Contoso.Account\") */\n  namespace: string;\n  /** Optional output filename relative to outDir (defaults to entry key + \".js\") */\n  out?: string;\n}\n\n/** Build configuration for WebResource bundling */\nexport interface BuildConfig {\n  /** Bundler to use (currently only \"esbuild\") */\n  bundler?: 'esbuild';\n  /** Named build entries: key = entry name, value = entry config */\n  entries: Record<string, BuildEntry>;\n  /** Output directory for built bundles (default: \"./dist\") */\n  outDir?: string;\n  /** JavaScript target version (default: \"es2020\") */\n  target?: string;\n  /** Generate source maps (default: true) */\n  sourcemap?: boolean;\n  /** Minify output (default: false) */\n  minify?: boolean;\n  /** Additional modules to exclude from bundling */\n  external?: string[];\n}\n\n/** Fully resolved build config with all defaults applied */\nexport interface ResolvedBuildConfig {\n  bundler: 'esbuild';\n  entries: Record<string, BuildEntry>;\n  outDir: string;\n  target: string;\n  sourcemap: boolean;\n  minify: boolean;\n  external: string[];\n}\n\n/**\n * Validate a raw build config object.\n * Throws BuildError with CONFIG_INVALID if any required field is missing or invalid.\n */\nexport function validateBuildConfig(raw: unknown): BuildConfig {\n  if (!raw || typeof raw !== 'object') {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration must be an object.',\n    );\n  }\n\n  const config = raw as Record<string, unknown>;\n\n  // entries: required, non-empty object\n  if (!config['entries'] || typeof config['entries'] !== 'object' || Array.isArray(config['entries'])) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration requires an \"entries\" object with at least one entry.',\n    );\n  }\n\n  const entries = config['entries'] as Record<string, unknown>;\n  const entryNames = Object.keys(entries);\n\n  if (entryNames.length === 0) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      'Build configuration requires at least one entry in \"entries\".',\n    );\n  }\n\n  for (const name of entryNames) {\n    const entry = entries[name] as Record<string, unknown> | undefined;\n\n    if (!entry || typeof entry !== 'object') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" must be an object with \"input\" and \"namespace\".`,\n        { entry: name },\n      );\n    }\n\n    if (!entry['input'] || typeof entry['input'] !== 'string') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" requires an \"input\" field (path to .ts source file).`,\n        { entry: name },\n      );\n    }\n\n    if (!entry['namespace'] || typeof entry['namespace'] !== 'string') {\n      throw new BuildError(\n        BuildErrorCode.CONFIG_INVALID,\n        `Entry \"${name}\" requires a \"namespace\" field (e.g. \"Contoso.Account\").`,\n        { entry: name },\n      );\n    }\n  }\n\n  // bundler: optional, must be \"esbuild\" if set\n  if (config['bundler'] !== undefined && config['bundler'] !== 'esbuild') {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      `Unsupported bundler: \"${String(config['bundler'])}\". Currently only \"esbuild\" is supported.`,\n      { bundler: config['bundler'] },\n    );\n  }\n\n  return config as unknown as BuildConfig;\n}\n\n/**\n * Apply default values to a validated build config.\n */\nexport function resolveBuildConfig(config: BuildConfig): ResolvedBuildConfig {\n  return {\n    bundler: config.bundler ?? 'esbuild',\n    entries: config.entries,\n    outDir: config.outDir ?? './dist',\n    target: config.target ?? 'es2020',\n    sourcemap: config.sourcemap ?? true,\n    minify: config.minify ?? false,\n    external: config.external ?? [],\n  };\n}\n","/**\n * @xrmforge/devkit - esbuild Builder\n *\n * Builds D365 WebResources as IIFE bundles with named globals.\n * Abstracts esbuild so users never write esbuild config.\n */\n\nimport * as esbuild from 'esbuild';\nimport { stat, mkdir } from 'node:fs/promises';\nimport { resolve, dirname } from 'node:path';\nimport type { BuildConfig } from '../config.js';\nimport { resolveBuildConfig } from '../config.js';\nimport { BuildError, BuildErrorCode } from '../errors.js';\nimport type { BuildResult, BuildResultEntry } from './types.js';\n\n/**\n * Build all entries defined in the config as IIFE bundles.\n *\n * @param config - Validated build configuration\n * @param cwd - Working directory for resolving relative paths (defaults to process.cwd())\n * @returns Build result with per-entry details\n */\nexport async function build(config: BuildConfig, cwd?: string): Promise<BuildResult> {\n  const startTime = Date.now();\n  const resolved = resolveBuildConfig(config);\n  const basedir = cwd ?? process.cwd();\n  const outDir = resolve(basedir, resolved.outDir);\n\n  // Ensure output directory exists\n  await mkdir(outDir, { recursive: true });\n\n  const entryNames = Object.keys(resolved.entries);\n  const results: BuildResultEntry[] = [];\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Build all entries in parallel\n  const settled = await Promise.allSettled(\n    entryNames.map(async (name) => {\n      const entry = resolved.entries[name]!;\n      const entryStart = Date.now();\n      const outFile = resolve(outDir, entry.out ?? `${name}.js`);\n\n      // Ensure subdirectory exists for custom out paths\n      await mkdir(dirname(outFile), { recursive: true });\n\n      const buildOptions: esbuild.BuildOptions = {\n        entryPoints: [resolve(basedir, entry.input)],\n        bundle: true,\n        format: 'iife',\n        globalName: entry.namespace,\n        outfile: outFile,\n        target: [resolved.target],\n        minify: resolved.minify,\n        sourcemap: resolved.sourcemap,\n        treeShaking: true,\n        logLevel: 'silent',\n        external: resolved.external,\n      };\n\n      const result = await esbuild.build(buildOptions);\n\n      // Collect esbuild warnings\n      for (const w of result.warnings) {\n        warnings.push(`[${name}] ${w.text}`);\n      }\n\n      // Get output file size\n      const stats = await stat(outFile);\n\n      return {\n        name,\n        outFile,\n        sizeBytes: stats.size,\n        durationMs: Date.now() - entryStart,\n      } satisfies BuildResultEntry;\n    }),\n  );\n\n  for (let i = 0; i < settled.length; i++) {\n    const outcome = settled[i]!;\n    const name = entryNames[i]!;\n\n    if (outcome.status === 'fulfilled') {\n      results.push(outcome.value);\n    } else {\n      const errorMsg = outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason);\n      // Distinguish \"file not found\" from other build errors\n      if (errorMsg.includes('Could not resolve') || errorMsg.includes('ENOENT')) {\n        errors.push(`[${name}] ${new BuildError(BuildErrorCode.ENTRY_NOT_FOUND, errorMsg, { entry: name }).message}`);\n      } else {\n        errors.push(`[${name}] ${new BuildError(BuildErrorCode.BUILD_FAILED, errorMsg, { entry: name }).message}`);\n      }\n    }\n  }\n\n  return {\n    entries: results,\n    totalDurationMs: Date.now() - startTime,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Start watch mode for all entries.\n * Returns a dispose function to stop watching.\n *\n * @param config - Validated build configuration\n * @param options - Watch options\n * @returns Object with dispose() to stop watching\n */\nexport async function watch(\n  config: BuildConfig,\n  options?: {\n    cwd?: string;\n    onRebuild?: (result: BuildResult) => void;\n  },\n): Promise<{ dispose: () => Promise<void> }> {\n  const resolved = resolveBuildConfig(config);\n  const basedir = options?.cwd ?? process.cwd();\n  const outDir = resolve(basedir, resolved.outDir);\n\n  await mkdir(outDir, { recursive: true });\n\n  const contexts: esbuild.BuildContext[] = [];\n\n  for (const [name, entry] of Object.entries(resolved.entries)) {\n    const outFile = resolve(outDir, entry.out ?? `${name}.js`);\n    await mkdir(dirname(outFile), { recursive: true });\n\n    const ctx = await esbuild.context({\n      entryPoints: [resolve(basedir, entry.input)],\n      bundle: true,\n      format: 'iife',\n      globalName: entry.namespace,\n      outfile: outFile,\n      target: [resolved.target],\n      minify: resolved.minify,\n      sourcemap: resolved.sourcemap,\n      treeShaking: true,\n      logLevel: 'silent',\n      external: resolved.external,\n    });\n\n    contexts.push(ctx);\n    await ctx.watch();\n  }\n\n  return {\n    dispose: async () => {\n      for (const ctx of contexts) {\n        await ctx.dispose();\n      }\n    },\n  };\n}\n","/**\n * @xrmforge/devkit - Project Scaffolding\n *\n * Generates a complete D365 form scripting project from templates.\n */\n\nimport { mkdir, writeFile, readdir, access } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { ScaffoldConfig, ScaffoldResult } from './types.js';\nimport { BuildError, BuildErrorCode } from '../errors.js';\nimport { loadTemplate } from './template-loader.js';\n\n/**\n * Scaffold a new D365 form scripting project.\n *\n * Creates a complete project structure with package.json, tsconfig,\n * xrmforge.config.json, example form script, and test file.\n *\n * @param config - Scaffold configuration\n * @returns List of created files and any warnings\n * @throws {BuildError} if target directory is not empty (unless files are only dotfiles)\n */\nexport async function scaffoldProject(config: ScaffoldConfig): Promise<ScaffoldResult> {\n  const { targetDir } = config;\n  const filesCreated: string[] = [];\n  const warnings: string[] = [];\n\n  // Ensure target directory exists\n  await mkdir(targetDir, { recursive: true });\n\n  // Check if directory is empty (ignore dotfiles and node_modules)\n  const existing = await readdir(targetDir);\n  const nonDotFiles = existing.filter((f) => !f.startsWith('.') && f !== 'node_modules');\n  if (nonDotFiles.length > 0 && !config.force) {\n    throw new BuildError(\n      BuildErrorCode.CONFIG_INVALID,\n      `Target directory is not empty: ${targetDir}\\n` +\n        `Found: ${nonDotFiles.slice(0, 5).join(', ')}${nonDotFiles.length > 5 ? '...' : ''}\\n` +\n        `Use --force to scaffold anyway (existing files will be skipped).`,\n      { targetDir, existingFiles: nonDotFiles },\n    );\n  }\n\n  // Create directory structure\n  const dirs = [\n    'src/forms',\n    'typings',\n    'tests/forms',\n  ];\n\n  for (const dir of dirs) {\n    await mkdir(join(targetDir, dir), { recursive: true });\n  }\n\n  // Generate and write all template files\n  const templates = await generateTemplates(config);\n\n  for (const [relativePath, content] of templates) {\n    const absolutePath = join(targetDir, relativePath);\n    await mkdir(join(absolutePath, '..'), { recursive: true });\n\n    // In force mode: skip files that already exist\n    if (config.force) {\n      try {\n        await access(absolutePath);\n        warnings.push(`Skipped ${relativePath} (already exists)`);\n        continue;\n      } catch {\n        // File doesn't exist, proceed with write\n      }\n    }\n\n    await writeFile(absolutePath, content, 'utf-8');\n    filesCreated.push(relativePath);\n  }\n\n  return { filesCreated, warnings };\n}\n\n/**\n * Generate all template file contents.\n * Returns an array of [relativePath, content] tuples.\n */\nasync function generateTemplates(config: ScaffoldConfig): Promise<Array<[string, string]>> {\n  const { projectName, prefix, namespace } = config;\n  const lowerPrefix = prefix.toLowerCase();\n  const namespaceVars = { namespace };\n\n  return [\n    ['package.json', generatePackageJson(projectName)],\n    ['tsconfig.json', generateTsConfig()],\n    ['xrmforge.config.json', generateXrmForgeConfig(lowerPrefix, namespace)],\n    ['vitest.config.ts', await loadTemplate('vitest.config.ts')],\n    ['.gitignore', await loadTemplate('gitignore')],\n    ['AGENT.md', await loadTemplate('AGENT.md')],\n    ['src/forms/example-form.ts', await loadTemplate('example-form.ts', namespaceVars)],\n    ['typings/.gitkeep', ''],\n    ['tests/forms/example-form.test.ts', await loadTemplate('example-form.test.ts', namespaceVars)],\n    ['.github/workflows/ci.yml', await loadTemplate('github-actions-ci.yml')],\n    ['azure-pipelines.yml', await loadTemplate('azure-pipelines.yml')],\n  ];\n}\n\nfunction generatePackageJson(projectName: string): string {\n  const pkg = {\n    name: projectName,\n    version: '0.1.0',\n    private: true,\n    type: 'module',\n    scripts: {\n      generate: 'xrmforge generate',\n      typecheck: 'tsc --noEmit',\n      build: 'xrmforge build',\n      watch: 'xrmforge build --watch',\n      test: 'vitest run',\n      'test:watch': 'vitest',\n    },\n    devDependencies: {\n      '@types/xrm': '^9.0.90',\n      '@xrmforge/cli': '^0.4.3',\n      '@xrmforge/testing': '^0.2.0',\n      '@xrmforge/helpers': '^0.1.0',\n      typescript: '^5.7.0',\n      vitest: '^3.0.0',\n    },\n  };\n  return JSON.stringify(pkg, null, 2) + '\\n';\n}\n\nfunction generateTsConfig(): string {\n  const config = {\n    compilerOptions: {\n      target: 'ES2020',\n      module: 'ESNext',\n      moduleResolution: 'bundler',\n      lib: ['ES2020', 'DOM'],\n      types: ['xrm'],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: false,\n      esModuleInterop: true,\n    },\n    include: [\n      'src/**/*.ts',\n      'typings/**/*.d.ts',\n      'typings/**/*.ts',\n    ],\n  };\n  return JSON.stringify(config, null, 2) + '\\n';\n}\n\nfunction generateXrmForgeConfig(prefix: string, namespace: string): string {\n  const config = {\n    build: {\n      outDir: `./dist/${prefix}_/JS`,\n      target: 'es2020',\n      sourcemap: true,\n      minify: true,\n      entries: {\n        example_form: {\n          input: './src/forms/example-form.ts',\n          namespace: `${namespace}.Example`,\n          out: 'Example/OnLoad.js',\n        },\n      },\n    },\n  };\n  return JSON.stringify(config, null, 2) + '\\n';\n}\n","/**\n * Template loader for scaffold templates.\n *\n * Reads template files from the templates/ directory relative to this module.\n * Supports {{placeholder}} variable substitution.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/** Path to the templates directory (relative to compiled output or source). */\nconst TEMPLATES_DIR = join(__dirname, 'templates');\n\n/**\n * Load a template file by name and optionally substitute variables.\n *\n * Variables in the template use the `{{key}}` syntax.\n *\n * @param name - Template filename (e.g. 'AGENT.md', 'example-form.ts')\n * @param vars - Optional key-value pairs for placeholder substitution\n * @returns Template content with variables replaced\n */\nexport async function loadTemplate(\n  name: string,\n  vars?: Record<string, string>,\n): Promise<string> {\n  const content = await readFile(join(TEMPLATES_DIR, name), 'utf-8');\n\n  if (!vars || Object.keys(vars).length === 0) {\n    return content;\n  }\n\n  return Object.entries(vars).reduce(\n    (result, [key, value]) => result.replaceAll(`{{${key}}}`, value),\n    content,\n  );\n}\n"],"mappings":"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","names":["BuildErrorCode","context","build","mkdir","join","dirname","mkdir","join"]}

package/dist/templates/AGENT.md

@@ -0,0 +1,189 @@
+# XrmForge - AI Agent Instructions
+
+This file helps AI coding assistants write optimal Dynamics 365 form scripts.
+
+## Packages
+
+- `@xrmforge/typegen` - Generates typed declarations from Dataverse metadata
+- `@xrmforge/helpers` - Browser-safe runtime: select(), parseLookup(), typedForm(), Xrm constants, Action executors
+- `@xrmforge/testing` - Type-safe form mocks: createFormMock(), fireOnChange()
+- `@xrmforge/devkit` - esbuild IIFE bundles via xrmforge build
+- `@xrmforge/eslint-plugin` - D365-specific ESLint rules
+
+## Generated Types (generated/ directory)
+
+Run `xrmforge generate` to create:
+- `generated/forms/{entity}.ts` - Form interface + Fields/Tabs/Sections/Subgrids enums
+- `generated/optionsets/{entity}.ts` - OptionSet const enums
+- `generated/entities/{entity}.ts` - Entity interface
+- `generated/fields/{entity}.ts` - Entity Fields enum for type-safe $select queries
+- `generated/entity-names.ts` - EntityNames const enum
+- `generated/index.ts` - Barrel file with `export * from` re-exports
+
+## Rules: Always
+
+1. **Fields Enum** for getAttribute/getControl (not raw strings):
+   `form.getAttribute(Fields.AccountName)` not `form.getAttribute("name")`
+
+2. **OptionSet Enum** for comparisons (not magic numbers):
+   `status === StatusCode.Active` not `status === 0`
+
+3. **Cast formContext** to generated form interface:
+   `const form = ctx.getFormContext() as AccountMainForm;`
+
+4. **EntityNames Enum** for Web API calls:
+   `Xrm.WebApi.retrieveRecord(EntityNames.Account, id)`
+
+5. **parseLookup()** from @xrmforge/helpers for lookup values
+
+6. **select()** from @xrmforge/helpers for $select queries
+
+7. **createFormMock()** from @xrmforge/testing for tests
+
+8. **Module exports** (not window/global assignments). esbuild globalName handles namespacing.
+
+9. **Tabs/Sections/Subgrids Enums** for UI access
+
+10. **Error handling** in all async event handlers (try/catch)
+
+## Rules: Never
+
+- Never `getAttribute("raw_string")` when Fields enum exists
+- Never magic numbers for OptionSet values
+- Never `Xrm.Page` (deprecated since D365 v9.0)
+- Never synchronous XMLHttpRequest
+- Never `eval()`
+- Never `window.X = ...` (use module exports)
+
+## Before/After Examples
+
+### Field Access
+```typescript
+// BEFORE: formContext.getAttribute("name").getValue()
+// AFTER:
+import { AccountMainFormFieldsEnum as Fields } from '../generated/forms/account.js';
+import type { AccountMainForm } from '../generated/forms/account.js';
+const form = ctx.getFormContext() as AccountMainForm;
+form.getAttribute(Fields.AccountName).getValue();  // StringAttribute, typed
+```
+
+### OptionSet Comparison
+```typescript
+// BEFORE: if (status.getValue() === 595300002) { ... }
+// AFTER:
+import { StatusCode } from '../generated/optionsets/invoice.js';
+if (status.getValue() === StatusCode.Gebucht) { ... }
+```
+
+### Testing
+```typescript
+import { createFormMock } from '@xrmforge/testing';
+const mock = createFormMock<AccountMainForm>({
+  name: 'Test', statuscode: 0
+});
+onLoad(mock.executionContext);
+expect(mock.formContext.getControl('revenue').getVisible()).toBe(true);
+```
+
+## File Structure
+
+```
+src/forms/{entity}-form.ts       - Form scripts (one per entity)
+src/shared/{name}.ts             - Shared utilities
+generated/                       - Generated types (do not edit manually)
+tests/forms/{entity}.test.ts     - Tests
+xrmforge.config.json             - Build config
+```
+
+## Pattern Recognition: Legacy to XrmForge
+
+When you see these patterns in legacy code, apply the XrmForge replacement:
+
+| Legacy Pattern | XrmForge Replacement |
+|---|---|
+| `getAttribute("name")` | `getAttribute(Fields.Name)` |
+| `getControl("name")` | `getControl(Fields.Name)` |
+| `getValue() === 595300000` | `getValue() === OptionSets.StatusCode.Active` |
+| `Xrm.WebApi.retrieveRecord("account", id)` | `Xrm.WebApi.retrieveRecord(EntityNames.Account, id)` |
+| `"?$select=name,revenue"` | `select(Fields.Name, Fields.Revenue)` (from @xrmforge/helpers) |
+| `value[0].id.replace("{","")...` | `parseLookup(form.getAttribute(Fields.X))` (from @xrmforge/helpers) |
+| `Xrm.Page.getAttribute(...)` | `formContext.getAttribute(...)` |
+| `var formContext` (global) | `const form = ctx.getFormContext()` (parameter) |
+| `function form_OnLoad(ctx)` | `export function onLoad(ctx: Xrm.Events.EventContext)` |
+| `.then(success, error)` | `async/await with try/catch` |
+
+### Creating OptionSet Enums from Legacy Magic Numbers
+
+When you find magic numbers like `getValue() === 105710002` in legacy code:
+1. Search the file for ALL numeric comparisons with getValue()
+2. Create a const enum in generated/optionsets/ with descriptive names
+3. Import and use the enum instead of the number
+
+Example:
+```typescript
+// generated/optionsets/invoice.ts
+export const enum InvoiceStatusCode {
+  Neu = 1,
+  Versendet = 105710000,
+  Abgeschlossen = 105710001,
+  Gebucht = 105710002,
+}
+
+// In the form script:
+import { InvoiceStatusCode } from '../../generated/optionsets/invoice.js';
+if (status.getValue() === InvoiceStatusCode.Gebucht) { ... }
+```
+
+## Testing with Global Xrm Mock
+
+Use `setupXrmMock()` from @xrmforge/testing to mock the global Xrm namespace:
+```typescript
+import { createFormMock, setupXrmMock, teardownXrmMock } from '@xrmforge/testing';
+
+beforeEach(() => setupXrmMock());
+afterEach(() => teardownXrmMock());
+
+// Override specific WebApi methods:
+setupXrmMock({
+  webApiOverrides: {
+    retrieveMultipleRecords: async () => ({ entities: [{ name: 'Test' }] }),
+  },
+});
+```
+
+## Build
+
+```bash
+npx xrmforge build               # IIFE bundles for D365
+npx xrmforge build --watch        # Watch mode (~10ms rebuilds)
+```
+
+## @types/xrm Pitfalls (known issues)
+
+When creating manual typings without `xrmforge generate`:
+
+1. **Form Interface:** Do NOT use `interface extends Xrm.FormContext` (getAttribute overload conflicts).
+   Use `Omit` pattern instead:
+   ```typescript
+   interface AccountMainForm extends Omit<Xrm.FormContext, 'getAttribute' | 'getControl'> {
+     getAttribute(name: Fields.AccountName): Xrm.Attributes.StringAttribute;
+     getAttribute(name: string): Xrm.Attributes.Attribute;
+     // ...
+   }
+   ```
+
+2. **AlertDialogResponse** does NOT exist in @types/xrm. Use `Xrm.Async.PromiseLike<void>`.
+
+3. **ConfirmDialogResponse** does NOT exist. Use `Xrm.Navigation.ConfirmResult`.
+
+4. **setNotification()** requires 2 arguments: (message, uniqueId).
+
+5. **openFile()** requires `fileSize` property in FileDetails.
+
+6. **const enum in .d.ts files** cannot be imported at runtime by test frameworks.
+   Since v0.8.0, XrmForge generates `.ts` files, so this is no longer an issue.
+   For manual typings, use regular `enum` in `.ts` files (not `.d.ts`).
+
+## Full Migration Guide
+
+See: https://www.npmjs.com/package/@xrmforge/typegen (MIGRATION.md)

package/dist/templates/azure-pipelines.yml

@@ -0,0 +1,32 @@
+trigger:
+  branches:
+    include:
+      - main
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+steps:
+  - task: NodeTool@0
+    inputs:
+      versionSpec: '20.x'
+    displayName: 'Install Node.js'
+
+  - script: npm ci
+    displayName: 'Install dependencies'
+
+  - script: npx xrmforge generate --from-config
+    displayName: 'Generate types from Dataverse'
+    env:
+      XRMFORGE_CLIENT_ID: $(XRMFORGE_CLIENT_ID)
+      XRMFORGE_CLIENT_SECRET: $(XRMFORGE_CLIENT_SECRET)
+      XRMFORGE_TENANT_ID: $(XRMFORGE_TENANT_ID)
+
+  - script: npx tsc --noEmit
+    displayName: 'Type check'
+
+  - script: npx vitest run
+    displayName: 'Test'
+
+  - script: npx xrmforge build
+    displayName: 'Build WebResources'

package/dist/templates/example-form.test.ts

@@ -0,0 +1,19 @@
+import { describe, it, expect } from 'vitest';
+
+/**
+ * Example test for the form script.
+ *
+ * Uses @xrmforge/testing for type-safe mocking once you have
+ * generated types. For now, this is a placeholder.
+ */
+describe('{{namespace}}.Example', () => {
+  it('should export onLoad function', async () => {
+    const mod = await import('../../src/forms/example-form.js');
+    expect(typeof mod.onLoad).toBe('function');
+  });
+
+  it('should export onSave function', async () => {
+    const mod = await import('../../src/forms/example-form.js');
+    expect(typeof mod.onSave).toBe('function');
+  });
+});

package/dist/templates/example-form.ts

@@ -0,0 +1,40 @@
+/**
+ * Example Form Script for Dynamics 365.
+ *
+ * Register in D365 as: {{namespace}}.Example.onLoad
+ *
+ * Replace this with your actual form logic.
+ */
+
+/**
+ * Called when the form loads.
+ */
+export function onLoad(executionContext: Xrm.Events.EventContext): void {
+  const formContext = executionContext.getFormContext();
+
+  // Example: show a notification on the form
+  formContext.ui.setFormNotification(
+    'Form loaded successfully',
+    'INFO',
+    'example-notification',
+  );
+
+  // Example: read a field value
+  // TODO: Replace with generated Fields enum after running 'xrmforge generate'
+  // Example: formContext.getAttribute(Fields.Name)
+  const nameAttr = formContext.getAttribute('name');
+  if (nameAttr) {
+    const value = nameAttr.getValue();
+    console.log('Name field value:', value);
+  }
+}
+
+/**
+ * Called when the form is saved.
+ */
+export function onSave(executionContext: Xrm.Events.EventContext): void {
+  const formContext = executionContext.getFormContext();
+
+  // Clear the notification on save
+  formContext.ui.clearFormNotification('example-notification');
+}

package/dist/templates/github-actions-ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - run: npm ci
+
+      - name: Generate types from Dataverse
+        run: npx xrmforge generate --from-config
+        env:
+          XRMFORGE_CLIENT_ID: ${{ secrets.XRMFORGE_CLIENT_ID }}
+          XRMFORGE_CLIENT_SECRET: ${{ secrets.XRMFORGE_CLIENT_SECRET }}
+          XRMFORGE_TENANT_ID: ${{ secrets.XRMFORGE_TENANT_ID }}
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Test
+        run: npx vitest run
+
+      - name: Build WebResources
+        run: npx xrmforge build

package/dist/templates/gitignore

@@ -0,0 +1,19 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# XrmForge cache
+.xrmforge/
+
+# IDE
+.vscode/settings.json
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log

package/dist/templates/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: false,
+    include: ['tests/**/*.test.ts'],
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrmforge/devkit",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Build orchestration and project tooling for Dynamics 365 WebResources",
   "keywords": [
     "dynamics-365",
@@ -46,7 +46,7 @@
     "node": ">=20.0.0"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node scripts/copy-templates.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",