@khester/create-dynamics-app 1.1.0 → 2.1.0

package/dist/artifacts/validators.js

@@ -0,0 +1,45 @@
+/**
+ * Input validators. User-supplied values (project name, PCF namespace /
+ * component name) are substituted raw into XML manifests, JSON, TypeScript
+ * identifiers, and filenames — so they must be format-checked before they enter
+ * the substitution bag, both from interactive prompts and from CLI flags.
+ */
+/** A single PascalCase-ish identifier (PCF constructor / component name). */
+const PCF_IDENTIFIER = /^[A-Za-z][A-Za-z0-9]*$/;
+/** A dot-separated set of identifiers (PCF namespace). */
+const PCF_NAMESPACE = /^[A-Za-z][A-Za-z0-9]*(\.[A-Za-z][A-Za-z0-9]*)*$/;
+/** npm-name-safe + filesystem-safe project name. */
+const PROJECT_NAME = /^[A-Za-z0-9._-]+$/;
+export function validateComponentName(value) {
+    return PCF_IDENTIFIER.test(value)
+        ? true
+        : `Component name must be a single identifier (letters/digits, starting with a letter), e.g. "RatingField". Got: ${JSON.stringify(value)}`;
+}
+export function validateNamespace(value) {
+    return PCF_NAMESPACE.test(value)
+        ? true
+        : `Namespace must be one or more dot-separated identifiers, e.g. "Contoso" or "Contoso.Controls". Got: ${JSON.stringify(value)}`;
+}
+/**
+ * Coerce an arbitrary name (e.g. a hyphenated project name) into a valid PCF
+ * identifier — PascalCase, alphanumeric, starting with a letter. Used to derive
+ * a safe default `componentName` so we never offer an invalid PCF constructor.
+ */
+export function toIdentifier(value) {
+    const joined = value
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    return /^[A-Za-z]/.test(joined) ? joined : `Control${joined}`;
+}
+export function validateProjectName(value) {
+    if (!value)
+        return 'Project name is required.';
+    if (value === '.' || value === '..')
+        return 'Project name cannot be "." or "..".';
+    return PROJECT_NAME.test(value)
+        ? true
+        : `Project name may only contain letters, digits, ".", "_" and "-" (no spaces, slashes, or quotes). Got: ${JSON.stringify(value)}`;
+}
+//# sourceMappingURL=validators.js.map

package/dist/artifacts/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/artifacts/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6EAA6E;AAC7E,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAChD,0DAA0D;AAC1D,MAAM,aAAa,GAAG,iDAAiD,CAAC;AACxE,oDAAoD;AACpD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,iHAAiH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/I,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,uGAAuG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACrI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,KAAK;SACjB,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,2BAA2B,CAAC;IAC/C,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,qCAAqC,CAAC;IAClF,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,yGAAyG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACvI,CAAC"}

package/dist/fromDesign.d.ts

@@ -0,0 +1,5 @@
+import type { ArtifactDescriptor, ComponentLibrary } from './artifacts/types.js';
+/** Whether `--from-design` is available for an artifact. */
+export declare function supportsFromDesign(descriptor: ArtifactDescriptor): boolean;
+export declare function scaffoldFromDesign(descriptor: ArtifactDescriptor, projectName: string, projectPath: string, library: ComponentLibrary | undefined, designPath: string): Promise<void>;
+//# sourceMappingURL=fromDesign.d.ts.map

package/dist/fromDesign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromDesign.d.ts","sourceRoot":"","sources":["../src/fromDesign.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAgBjF,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAE1E;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,kBAAkB,EAC9B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqFf"}

package/dist/fromDesign.js

@@ -0,0 +1,98 @@
+/**
+ * From-design scaffolding: turn a form-builder export (a FormBuilderProject JSON)
+ * into a deployable artifact by running the export engine's generators.
+ *
+ * `previewExport` returns the full project as `GeneratedFile[]` (host + form code +
+ * a design-derived data-access layer + its own token tooling) for the artifact's
+ * export target; we write those to disk. The v9-required gate is checked first via
+ * `validateExportTarget`, which RETURNS a result (it does not throw).
+ *
+ * NOTE: the output is structurally DIFFERENT from the blank-starter templates — it
+ * is generated by @dataverse-kit/export-engine (e.g. a CRA-based web resource), ships
+ * its OWN token tooling, and is recorded by `package.json.dynamicsKit.artifact`. The
+ * driver therefore skips create-app's dev-tools injection for from-design.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { previewExport, validateExportTarget } from '@dataverse-kit/export-engine';
+/** Export targets the export engine can generate from a design. */
+const EXPORTABLE = ['web-resource', 'pcf', 'static-web-app'];
+/** The export-engine target for an artifact, or undefined if from-design is unsupported. */
+function exportTargetOf(descriptor) {
+    return EXPORTABLE.find((t) => t === descriptor.exportTarget);
+}
+/** Whether `--from-design` is available for an artifact. */
+export function supportsFromDesign(descriptor) {
+    return exportTargetOf(descriptor) !== undefined;
+}
+export async function scaffoldFromDesign(descriptor, projectName, projectPath, library, designPath) {
+    const target = exportTargetOf(descriptor);
+    if (!target) {
+        console.error(chalk.red(`❌ --from-design is not supported for "${descriptor.id}".`) +
+            ` Supported targets: web-resource, pcf, static-web-app.`);
+        process.exit(1);
+        return;
+    }
+    if (!(await fs.pathExists(designPath))) {
+        console.error(chalk.red(`❌ Design file not found: ${designPath}`));
+        process.exit(1);
+    }
+    let project;
+    try {
+        project = (await fs.readJson(designPath));
+    }
+    catch (e) {
+        console.error(chalk.red(`❌ Design file is not valid JSON: ${String(e)}`));
+        process.exit(1);
+        return;
+    }
+    if (!Array.isArray(project.forms) || project.forms.length === 0) {
+        console.error(chalk.red('❌ Design file has no `forms` — is it a FormBuilderProject export?'));
+        process.exit(1);
+    }
+    const options = {
+        target,
+        projectName,
+        includeDeployScript: false,
+        minify: false,
+        exportMethod: 'folder',
+        ...(library ? { componentLibrary: library } : {}),
+    };
+    // The v9-required gate RETURNS a result; it does not throw.
+    const check = validateExportTarget(project, options);
+    if (!check.ok) {
+        console.error(chalk.red('\n❌ This design uses Fluent v9-only controls but resolves to Fluent v8'));
+        console.error(chalk.gray('   (from your --v8/--library flag or the project default):'));
+        for (const ref of check.reason.required) {
+            const control = ref.controlType ?? JSON.stringify(ref);
+            const form = ref.formName;
+            console.error(chalk.gray(`   - ${control}${form ? ` on form "${form}"` : ''}`));
+        }
+        console.error(chalk.cyan('\n   Re-run with --v9 to generate Fluent v9 output.\n'));
+        process.exit(1);
+    }
+    let files;
+    try {
+        files = previewExport(project, options);
+    }
+    catch (e) {
+        console.error(chalk.red('❌ Could not generate from this design — it parsed as JSON but is not a complete FormBuilderProject.'));
+        console.error(chalk.gray(String(e instanceof Error ? e.message : e)));
+        process.exit(1);
+        return;
+    }
+    // Write each generated file, refusing any path that escapes the project directory.
+    const projectRoot = path.resolve(projectPath);
+    for (const file of files) {
+        const dest = path.resolve(projectRoot, file.path);
+        if (dest !== projectRoot && !dest.startsWith(projectRoot + path.sep)) {
+            console.error(chalk.red(`❌ Generated file path escapes the project directory: ${file.path}`));
+            process.exit(1);
+        }
+        await fs.outputFile(dest, file.content);
+    }
+    console.log(chalk.green(`  ✓ Generated ${files.length} files from ${project.forms.length} form(s) in "${project.name}".`));
+    console.log(chalk.gray('  ℹ️  The export engine generated a typed data layer + token tooling — see the project README.'));
+}
+//# sourceMappingURL=fromDesign.js.map

package/dist/fromDesign.js.map

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

package/dist/index.js

@@ -5,218 +5,170 @@ import chalk from 'chalk';
 import path from 'path';
 import fs from 'fs-extra';
 import { copyTemplate } from './utils/copyTemplate.js';
+import { applyTemplatePlan } from './templatePlan.js';
+import { injectDevTools, applyConditionalDeps } from './injectDevTools.js';
+import { scaffoldFromDesign, supportsFromDesign } from './fromDesign.js';
 import { updatePackageJson } from './utils/updatePackageJson.js';
 import { installDependencies } from './utils/installDependencies.js';
 import { initGit } from './utils/initGit.js';
-import { generateEntities, generatePageTemplates, customizeForDeployment, } from './utils/consultingHelpers.js';
+import { ARTIFACTS } from './artifacts/registry.js';
+import { validateProjectName } from './artifacts/validators.js';
+import { CLI_VERSION, resolveArtifact, resolveLibraryFromFlags, resolveWithComponents, runArtifactPrompts, buildTemplateVariables, } from './scaffold.js';
 const program = new Command();
 program
     .name('create-dynamics-app')
-    .description('Create a new Dynamics UI Kit project - Enterprise Consulting Edition')
-    .version('2.0.0')
+    .description('Scaffold Dynamics 365 / Power Platform artifacts (unified CLI)')
+    .version(CLI_VERSION)
     .argument('<project-name>', 'name of the project')
-    .option('-t, --template <template>', 'template to use (power-pages, dynamics-365)')
-    .option('-c, --client-name <name>', 'client name for project customization')
-    .option('-e, --entities <entities>', 'comma-separated list of entities to generate (e.g., "opportunity,quote,invoice")')
-    .option('-p, --page-type <type>', 'specific page template (entity-list, entity-detail, entity-dashboard, search, related-entities)')
-    .option('-d, --deployment-target <target>', 'target environment (dev, test, prod)')
-    .option('--generate-sample', 'generate sample entities and pages for demonstration')
+    .option('-a, --artifact <id>', `artifact type (${ARTIFACTS.filter((a) => a.available).map((a) => a.id).join(', ')})`)
+    .option('-t, --template <template>', '[deprecated] legacy template flag')
+    .option('-l, --library <library>', 'component library: fluent-v8 (default) or fluent-v9')
+    .option('--v8', 'shorthand for --library fluent-v8')
+    .option('--v9', 'shorthand for --library fluent-v9')
+    .option('-n, --namespace <namespace>', 'namespace for PCF control')
+    .option('--component-name <name>', 'component name for PCF control')
+    .option('--property-type <type>', 'PCF bound property type (e.g. SingleLine.Text, TwoOptions)')
+    .option('--graph', 'include Microsoft Graph integration (teams-app)')
+    .option('--with-components', 'install @khester/reusable-components (Fluent v8) — react-custom-page, power-pages, web-resource, dialog-form')
+    .option('--from-design <file>', 'generate from a form-builder export (FormBuilderProject JSON)')
     .option('--skip-git', 'skip git repository initialization')
     .option('--skip-install', 'skip dependency installation')
     .action(async (projectName, options) => {
     try {
-        console.log(chalk.cyan(`\n🚀 Creating ${projectName} - Enterprise Consulting Edition...\n`));
         // Validate project name
-        if (!projectName ||
-            projectName.includes('/') ||
-            projectName.includes('\\')) {
-            console.error(chalk.red('❌ Please provide a valid project name'));
+        const nameCheck = validateProjectName(projectName);
+        if (nameCheck !== true) {
+            console.error(chalk.red(`❌ ${nameCheck}`));
+            process.exit(1);
+        }
+        if (options.fromDesign && options.template) {
+            console.error(chalk.red('❌ --from-design cannot be combined with the deprecated --template; use --artifact.'));
             process.exit(1);
         }
         const projectPath = path.resolve(process.cwd(), projectName);
-        // Check if directory already exists
         if (await fs.pathExists(projectPath)) {
             console.error(chalk.red(`❌ Directory ${projectName} already exists`));
             process.exit(1);
         }
-        let template = options.template;
-        let clientName = options.clientName;
-        let entities = options.entities;
-        let pageType = options.pageType;
-        let deploymentTarget = options.deploymentTarget;
-        // Enhanced prompts for consulting workflow
-        if (!template) {
-            const answers = await inquirer.prompt([
-                {
-                    type: 'list',
-                    name: 'template',
-                    message: 'Which template would you like to use?',
-                    choices: [
-                        {
-                            name: '🌐 Power Pages - For Power Pages portal development',
-                            value: 'power-pages',
-                        },
-                        {
-                            name: '⚡ Dynamics 365 - For Dynamics 365 custom controls and forms (Recommended for consulting)',
-                            value: 'dynamics-365',
-                        },
-                    ],
-                },
-            ]);
-            template = answers.template;
+        const descriptor = await resolveArtifact(options);
+        if (options.fromDesign && !supportsFromDesign(descriptor)) {
+            console.error(chalk.red(`❌ --from-design is not supported for "${descriptor.id}".`) +
+                ' Supported targets: web-resource, pcf, static-web-app.');
+            process.exit(1);
         }
-        // Consulting-specific prompts for Dynamics 365 template
-        if (template === 'dynamics-365') {
-            const consultingAnswers = await inquirer.prompt([
-                {
-                    type: 'input',
-                    name: 'clientName',
-                    message: 'Client name (for project customization):',
-                    default: clientName || 'Client',
-                    when: !clientName,
-                },
-                {
-                    type: 'input',
-                    name: 'entities',
-                    message: 'Entities to generate (comma-separated, e.g., "opportunity,quote,invoice"):',
-                    default: entities || '',
-                    when: !entities && !options.generateSample,
-                },
-                {
-                    type: 'list',
-                    name: 'pageType',
-                    message: 'Primary page template to include:',
-                    choices: [
-                        {
-                            name: '📋 Entity List - Standard CRUD list page',
-                            value: 'entity-list',
-                        },
-                        {
-                            name: '📄 Entity Detail - Master-detail view',
-                            value: 'entity-detail',
-                        },
-                        {
-                            name: '📊 Entity Dashboard - KPI and analytics view',
-                            value: 'entity-dashboard',
-                        },
-                        { name: '🔍 Search Page - Cross-entity search', value: 'search' },
-                        {
-                            name: '🔗 Related Entities - Master-detail relationships',
-                            value: 'related-entities',
-                        },
-                        {
-                            name: '🎯 All Templates - Include all page templates',
-                            value: 'all',
-                        },
-                    ],
-                    default: pageType || 'all',
-                    when: !pageType,
-                },
-                {
-                    type: 'list',
-                    name: 'deploymentTarget',
-                    message: 'Primary deployment target:',
-                    choices: [
+        console.log(chalk.cyan(`\n🚀 Creating ${projectName} — ${descriptor.label}\n`));
+        // Resolve the library + (blank path) prompts/vars BEFORE creating the directory,
+        // so an input-validation failure exits without leaving an orphaned project dir.
+        let library;
+        // `vars` is only used by the blank path (drives conditionalDeps).
+        let vars;
+        if (options.fromDesign) {
+            // Library comes from flags; export-engine resolves it from the design when unset.
+            library = resolveLibraryFromFlags(options);
+            if (options.withComponents) {
+                console.log(chalk.yellow("⚠️  --with-components is ignored with --from-design (the generated output ships the export engine's own dependencies)."));
+            }
+        }
+        else {
+            if (descriptor.supportsLibraryChoice) {
+                library = resolveLibraryFromFlags(options);
+                if (!library && !process.stdin.isTTY) {
+                    library = descriptor.defaultLibrary ?? 'fluent-v8';
+                }
+                if (!library) {
+                    const reply = await inquirer.prompt([
                         {
-                            name: '🛠️  Development - Local development environment',
-                            value: 'dev',
+                            type: 'list',
+                            name: 'library',
+                            message: 'Fluent UI version for generated output:',
+                            choices: [
+                                { name: 'Fluent UI v8 (Power Pages / Canvas PCF safe)', value: 'fluent-v8' },
+                                { name: 'Fluent UI v9 (modern)', value: 'fluent-v9' },
+                            ],
+                            default: descriptor.defaultLibrary ?? 'fluent-v8',
                         },
-                        { name: '🧪 Test - Testing environment', value: 'test' },
-                        { name: '🚀 Production - Production environment', value: 'prod' },
-                    ],
-                    default: deploymentTarget || 'dev',
-                    when: !deploymentTarget,
-                },
-                {
-                    type: 'confirm',
-                    name: 'generateSample',
-                    message: 'Generate sample entities and pages for demonstration?',
-                    default: options.generateSample || false,
-                    when: !options.generateSample && !entities,
-                },
-            ]);
-            clientName = clientName || consultingAnswers.clientName;
-            entities = entities || consultingAnswers.entities;
-            pageType = pageType || consultingAnswers.pageType;
-            deploymentTarget =
-                deploymentTarget || consultingAnswers.deploymentTarget;
-            options.generateSample =
-                options.generateSample || consultingAnswers.generateSample;
-        }
-        // Validate template
-        if (!template || !['power-pages', 'dynamics-365'].includes(template)) {
-            console.error(chalk.red('❌ Invalid template. Choose power-pages or dynamics-365'));
-            process.exit(1);
+                    ]);
+                    library = reply.library;
+                }
+            }
+            // --with-components: opt-in @khester/reusable-components (Fluent v8).
+            const wc = resolveWithComponents(descriptor, library, options.withComponents);
+            if (wc.kind === 'warn') {
+                console.log(chalk.yellow(`⚠️  ${wc.message}`));
+            }
+            else if (wc.kind === 'error') {
+                console.error(chalk.red(`❌ ${wc.message}`));
+                process.exit(1);
+            }
+            const answers = await runArtifactPrompts(descriptor, projectName, options);
+            vars = buildTemplateVariables(descriptor, projectName, answers, library, options.withComponents);
         }
-        // Create project directory
+        // From here on we touch the filesystem. Clean up the created directory on any
+        // failure so a transient error doesn't permanently block a retry (create refuses
+        // a non-empty directory).
         await fs.ensureDir(projectPath);
-        // Copy template files
-        await copyTemplate(template, projectPath);
-        // Update package.json with project name and client info
-        await updatePackageJson(projectPath, projectName, clientName);
-        // Generate entities if specified
-        if (template === 'dynamics-365' && (entities || options.generateSample)) {
-            await generateEntities(projectPath, entities, options.generateSample);
-        }
-        // Generate page templates if specified
-        if (template === 'dynamics-365' && pageType) {
-            await generatePageTemplates(projectPath, pageType, entities, options.generateSample);
-        }
-        // Customize for deployment target
-        if (deploymentTarget) {
-            await customizeForDeployment(projectPath, deploymentTarget);
-        }
-        // Initialize git repository
-        if (!options.skipGit) {
-            await initGit(projectPath);
+        try {
+            if (options.fromDesign) {
+                await scaffoldFromDesign(descriptor, projectName, projectPath, library, options.fromDesign);
+            }
+            else {
+                await copyTemplate(descriptor.templateDir, projectPath, vars);
+                await applyTemplatePlan(projectPath, descriptor, vars);
+            }
+            const provenance = {
+                cliVersion: CLI_VERSION,
+                artifact: descriptor.id,
+                componentLibrary: library,
+                templateVersion: descriptor.templateVersion,
+            };
+            await updatePackageJson(projectPath, projectName, { provenance });
+            // From-design output ships the export engine's own tooling — don't inject ours
+            // (a second, incompatible token chain) on top. Blank starters get the dev-tools.
+            if (!options.fromDesign) {
+                await injectDevTools(projectPath, descriptor.devTools);
+                if (vars)
+                    await applyConditionalDeps(projectPath, descriptor, vars);
+            }
+            if (!options.skipGit) {
+                await initGit(projectPath);
+            }
+            if (!options.skipInstall) {
+                await installDependencies(projectPath);
+            }
         }
-        // Install dependencies
-        if (!options.skipInstall) {
-            await installDependencies(projectPath);
+        catch (err) {
+            await fs.remove(projectPath).catch(() => undefined);
+            throw err;
         }
-        // Success message with consulting-specific information
         console.log(chalk.green(`\n✅ Successfully created ${projectName}!\n`));
-        if (clientName) {
-            console.log(chalk.blue(`👤 Client: ${clientName}`));
-        }
-        if (entities) {
-            console.log(chalk.blue(`📊 Generated entities: ${entities}`));
-        }
-        if (pageType && pageType !== 'all') {
-            console.log(chalk.blue(`📄 Page template: ${pageType}`));
-        }
-        if (deploymentTarget) {
-            console.log(chalk.blue(`🎯 Deployment target: ${deploymentTarget}`));
-        }
-        console.log(chalk.cyan('\n📝 Next steps:'));
+        console.log(chalk.cyan('📝 Next steps:'));
         console.log(`   cd ${projectName}`);
-        if (options.skipInstall) {
+        if (options.skipInstall)
             console.log('   npm install');
-        }
-        if (template === 'power-pages') {
+        if (descriptor.id === 'power-pages') {
             console.log('   npm run dev         # Start development server');
             console.log('   npm run build       # Build for production');
-            console.log("\n📖 Don't forget to:");
-            console.log('   - Copy .env.example to .env');
-            console.log('   - Set your PORTAL_URL in .env');
+            console.log("\n📖 Don't forget to copy .env.example to .env and set PORTAL_URL.");
+        }
+        else if (descriptor.id === 'pcf-field' || descriptor.id === 'pcf-dataset') {
+            console.log('   npm run build       # Build the control');
+            console.log('   npm start           # Start the PCF test harness');
         }
         else {
-            console.log('   npm run build:dev   # Build for development');
-            console.log('   npm run build:prod  # Build for production');
-            console.log('   npm run start       # Start development server');
-            if (entities || options.generateSample) {
-                console.log('\n🔧 Entity generator commands:');
-                console.log('   npm run generate:entity -- --entity customentity --display-name "Custom Entity"');
+            console.log('   npm run dev         # Start development server');
+            console.log('   npm run build       # Build for production');
+            if (descriptor.devTools.includes('codegen')) {
+                console.log('\n🔧 Generate typed entities from a live org:');
+                console.log('   npm run metadata:pull -- --entities account,contact');
             }
-            console.log('\n📖 Consulting workflow:');
-            console.log('   1. Review generated entities and customize field constants');
-            console.log('   2. Update validation rules in entity models');
-            console.log('   3. Customize page templates for client requirements');
-            console.log('   4. Run quality checks: npm run quality');
-            console.log('   5. Deploy: npm run build:d365');
-            console.log('\n📚 Check docs/ folder for deployment guides');
         }
-        console.log(chalk.magenta('\n🎉 Ready for enterprise consulting!\n'));
+        if (library === 'fluent-v9') {
+            console.log(chalk.gray('\nℹ️  Fluent v9 selected — code is emitted and builds. A blank v9 form renders bare until you add controls.'));
+        }
+        if (!options.fromDesign && options.withComponents && descriptor.supportsComponents) {
+            console.log(chalk.gray("\n📦 @khester/reusable-components installed — e.g. import { ReusableCard, CustomSection } from '@khester/reusable-components'."));
+        }
+        console.log(chalk.magenta('\n🎉 Done.\n'));
     }
     catch (error) {
         console.error(chalk.red('❌ An error occurred:'), error);

package/dist/index.js.map

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

package/dist/injectDevTools.d.ts

@@ -0,0 +1,28 @@
+import type { ArtifactDescriptor, DevToolId } from './artifacts/types.js';
+interface PackageJson {
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/** Compare two npm version ranges loosely; return the higher (keeping its prefix). */
+export declare function pickHigherRange(a: string, b: string): string;
+export interface DevToolPlan {
+    pkg: PackageJson;
+    filesToCopy: Array<{
+        from: string;
+        to: string;
+    }>;
+    added: string[];
+    skipped: DevToolId[];
+    warnings: string[];
+}
+/** Pure: compute the merged package.json + file-copy plan. No IO. */
+export declare function planDevTools(pkg: PackageJson, toolIds: DevToolId[]): DevToolPlan;
+/** Impure: apply the dev-tool plan to a generated project. */
+export declare function injectDevTools(projectPath: string, toolIds: DevToolId[]): Promise<void>;
+/** Add an artifact's conditional dependencies whose `when(vars)` predicate holds.
+ * Each condition may target a sub-package via `packagePath` (e.g. an SWA `frontend`). */
+export declare function applyConditionalDeps(projectPath: string, descriptor: ArtifactDescriptor, vars: Record<string, string>): Promise<void>;
+export {};
+//# sourceMappingURL=injectDevTools.d.ts.map

package/dist/injectDevTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectDevTools.d.ts","sourceRoot":"","sources":["../src/injectDevTools.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAwC1E,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,CAyChF;AAED,8DAA8D;AAC9D,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB7F;AAED;yFACyF;AACzF,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkCf"}