@khester/create-dynamics-app 1.1.0 → 2.1.0

package/dist/injectDevTools.js

@@ -0,0 +1,148 @@
+/**
+ * Inject the dev-tools an artifact declares (`descriptor.devTools`) into a
+ * generated project: merge npm scripts + deps into package.json and copy the tool
+ * files from templates/_shared/dev-tools.
+ *
+ * Collision policy (the review's concern — naive "template-wins" silently drops a
+ * tool's wiring): if the template ALREADY defines any of a tool's script names,
+ * the whole tool is skipped (the template provides it) and a notice is printed —
+ * never a silent half-merge. Dependency clashes take the higher version range.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const sharedToolsDir = fileURLToPath(new URL('../templates/_shared/dev-tools', import.meta.url));
+const CODEGEN_DEP = { '@dataverse-kit/dataverse-codegen': '^0.1.0' };
+const DEV_TOOLS = {
+    token: {
+        scripts: { 'auth:token': 'node tools/auth/get-token.js' },
+        files: [{ from: 'auth/get-token.js', to: 'tools/auth/get-token.js' }],
+    },
+    serve: {
+        // No script (the artifact's own dev server runs); just ship the mock-Xrm helper.
+        files: [{ from: 'dev/mock-xrm.js', to: 'tools/dev/mock-xrm.js' }],
+    },
+    codegen: {
+        scripts: {
+            'metadata:pull': 'node tools/metadata-sync/index.js pull',
+            'metadata:sync': 'node tools/metadata-sync/index.js sync',
+            'metadata:generate': 'node tools/metadata-sync/index.js generate',
+            'metadata:validate': 'node tools/metadata-sync/index.js validate',
+        },
+        devDependencies: { commander: '^11.1.0', ...CODEGEN_DEP },
+        files: [{ from: 'metadata-sync/index.js', to: 'tools/metadata-sync/index.js' }],
+    },
+    smoke: {
+        scripts: { 'smoke:live': 'node tools/smoke/test-retrieve.js' },
+        devDependencies: { ...CODEGEN_DEP },
+        files: [{ from: 'smoke/test-retrieve.js', to: 'tools/smoke/test-retrieve.js' }],
+    },
+};
+/** Compare two npm version ranges loosely; return the higher (keeping its prefix). */
+export function pickHigherRange(a, b) {
+    const nums = (r) => r.replace(/^[^0-9]*/, '').split('.').map((n) => parseInt(n, 10) || 0);
+    const x = nums(a);
+    const y = nums(b);
+    for (let i = 0; i < 3; i++) {
+        if ((x[i] || 0) !== (y[i] || 0))
+            return (x[i] || 0) > (y[i] || 0) ? a : b;
+    }
+    return a;
+}
+/** Pure: compute the merged package.json + file-copy plan. No IO. */
+export function planDevTools(pkg, toolIds) {
+    const out = JSON.parse(JSON.stringify(pkg));
+    out.scripts = out.scripts || {};
+    out.dependencies = out.dependencies || {};
+    out.devDependencies = out.devDependencies || {};
+    const filesToCopy = [];
+    const added = [];
+    const skipped = [];
+    const warnings = [];
+    for (const id of toolIds) {
+        const tool = DEV_TOOLS[id];
+        if (!tool)
+            continue;
+        const scriptNames = Object.keys(tool.scripts || {});
+        const collisions = scriptNames.filter((s) => out.scripts[s] !== undefined);
+        if (scriptNames.length > 0 && collisions.length > 0) {
+            skipped.push(id);
+            warnings.push(`dev-tool "${id}" skipped — template already defines: ${collisions.join(', ')}`);
+            continue;
+        }
+        for (const [name, cmd] of Object.entries(tool.scripts || {})) {
+            out.scripts[name] = cmd;
+            added.push(name);
+        }
+        for (const [dep, ver] of Object.entries(tool.dependencies || {})) {
+            out.dependencies[dep] = out.dependencies[dep]
+                ? pickHigherRange(out.dependencies[dep], ver)
+                : ver;
+        }
+        for (const [dep, ver] of Object.entries(tool.devDependencies || {})) {
+            out.devDependencies[dep] = out.devDependencies[dep]
+                ? pickHigherRange(out.devDependencies[dep], ver)
+                : ver;
+        }
+        for (const f of tool.files || [])
+            filesToCopy.push(f);
+    }
+    return { pkg: out, filesToCopy, added, skipped, warnings };
+}
+/** Impure: apply the dev-tool plan to a generated project. */
+export async function injectDevTools(projectPath, toolIds) {
+    if (!toolIds || toolIds.length === 0)
+        return;
+    const pkgPath = path.join(projectPath, 'package.json');
+    if (!(await fs.pathExists(pkgPath)))
+        return;
+    const pkg = (await fs.readJson(pkgPath));
+    const plan = planDevTools(pkg, toolIds);
+    for (const f of plan.filesToCopy) {
+        await fs.ensureDir(path.dirname(path.join(projectPath, f.to)));
+        await fs.copy(path.join(sharedToolsDir, f.from), path.join(projectPath, f.to), {
+            overwrite: true,
+        });
+    }
+    await fs.writeJson(pkgPath, plan.pkg, { spaces: 2 });
+    for (const w of plan.warnings)
+        console.log(`  ℹ️  ${w}`);
+}
+/** 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 async function applyConditionalDeps(projectPath, descriptor, vars) {
+    const conds = (descriptor.conditionalDeps ?? []).filter((c) => c.when(vars));
+    if (conds.length === 0)
+        return;
+    // Group matched conditions by their target package.json (default: root).
+    const byPath = new Map();
+    for (const cond of conds) {
+        const rel = cond.packagePath ?? '.';
+        (byPath.get(rel) ?? byPath.set(rel, []).get(rel)).push(cond);
+    }
+    for (const [rel, group] of byPath) {
+        const pkgPath = path.join(projectPath, rel, 'package.json');
+        if (!(await fs.pathExists(pkgPath)))
+            continue;
+        const pkg = (await fs.readJson(pkgPath));
+        let changed = false;
+        for (const cond of group) {
+            const buckets = [
+                ['dependencies', cond.dependencies],
+                ['devDependencies', cond.devDependencies],
+            ];
+            for (const [field, deps] of buckets) {
+                if (!deps)
+                    continue;
+                pkg[field] = pkg[field] || {};
+                for (const [dep, ver] of Object.entries(deps)) {
+                    pkg[field][dep] = pkg[field][dep] ? pickHigherRange(pkg[field][dep], ver) : ver;
+                    changed = true;
+                }
+            }
+        }
+        if (changed)
+            await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+    }
+}
+//# sourceMappingURL=injectDevTools.js.map

package/dist/injectDevTools.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,48 @@
+import type { ArtifactDescriptor, ComponentLibrary } from './artifacts/types.js';
+export declare const CLI_VERSION: string;
+export interface ProjectOptions {
+    artifact?: string;
+    template?: string;
+    library?: string;
+    v8?: boolean;
+    v9?: boolean;
+    namespace?: string;
+    componentName?: string;
+    propertyType?: string;
+    graph?: boolean;
+    withComponents?: boolean;
+    fromDesign?: string;
+    skipGit?: boolean;
+    skipInstall?: boolean;
+}
+/** Resolve the chosen Fluent library from flags, or undefined to prompt/default. */
+export declare function resolveLibraryFromFlags(options: ProjectOptions): ComponentLibrary | undefined;
+/**
+ * Outcome of resolving `--with-components` against an artifact + chosen library.
+ * Pure so the driver's guard is unit-testable (index.ts just prints + exits).
+ *  - `apply`: inject @khester/reusable-components
+ *  - `skip`:  flag not set
+ *  - `warn`:  flag set but the artifact can't host the components → warn, continue
+ *  - `error`: flag set with Fluent v9 on a v8/v9 host → print + exit non-zero
+ */
+export type WithComponentsOutcome = {
+    kind: 'apply';
+} | {
+    kind: 'skip';
+} | {
+    kind: 'warn';
+    message: string;
+} | {
+    kind: 'error';
+    message: string;
+};
+export declare function resolveWithComponents(descriptor: ArtifactDescriptor, library: ComponentLibrary | undefined, withComponents: boolean | undefined): WithComponentsOutcome;
+/** Map known CLI flags to prompt answers so we don't re-ask for them. */
+export declare function prefilledAnswers(options: ProjectOptions): Record<string, string>;
+/** Run an artifact's prompts, skipping any already provided via flags. */
+export declare function runArtifactPrompts(descriptor: ArtifactDescriptor, projectName: string, options: ProjectOptions): Promise<Record<string, string>>;
+/** Build the `{{var}}` substitution bag from answers + the artifact's derive() hook. */
+export declare function buildTemplateVariables(descriptor: ArtifactDescriptor, projectName: string, answers: Record<string, string>, library?: ComponentLibrary, withComponents?: boolean): Record<string, string>;
+/** Resolve the artifact to scaffold from flags/prompts; handles legacy --template. */
+export declare function resolveArtifact(options: ProjectOptions): Promise<ArtifactDescriptor>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,WAAW,QAA8D,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAO7F;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvC,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,cAAc,EAAE,OAAO,GAAG,SAAS,GAClC,qBAAqB,CAiBvB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,kBAAkB,EAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwDjC;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,kBAAkB,EAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,gBAAgB,EAC1B,cAAc,CAAC,EAAE,OAAO,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAED,sFAAsF;AACtF,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsE1F"}

package/dist/scaffold.js

@@ -0,0 +1,180 @@
+/**
+ * Scaffold driver helpers — extracted from the commander entrypoint so they are
+ * importable + unit-testable without triggering `program.parse()`. The orchestration
+ * (the ordered steps) lives in `index.ts`; the decision logic lives here.
+ */
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { createRequire } from 'module';
+import { availableArtifacts, getArtifact, TEMPLATE_FLAG_MIGRATIONS, } from './artifacts/registry.js';
+import { toIdentifier } from './artifacts/validators.js';
+const require = createRequire(import.meta.url);
+export const CLI_VERSION = require('../package.json').version;
+/** Resolve the chosen Fluent library from flags, or undefined to prompt/default. */
+export function resolveLibraryFromFlags(options) {
+    if (options.v9)
+        return 'fluent-v9';
+    if (options.v8)
+        return 'fluent-v8';
+    if (options.library === 'fluent-v8' || options.library === 'fluent-v9') {
+        return options.library;
+    }
+    return undefined;
+}
+const COMPONENT_HOSTS = 'react-custom-page, power-pages, web-resource, dialog-form';
+export function resolveWithComponents(descriptor, library, withComponents) {
+    if (!withComponents)
+        return { kind: 'skip' };
+    if (!descriptor.supportsComponents) {
+        return {
+            kind: 'warn',
+            message: `--with-components is ignored for "${descriptor.id}". Supported: ${COMPONENT_HOSTS}.`,
+        };
+    }
+    if (library === 'fluent-v9') {
+        return {
+            kind: 'error',
+            message: `--with-components ships Fluent v8 components and can't combine with Fluent v9 on "${descriptor.id}". ` +
+                'Re-run with --v8 (or drop --with-components).',
+        };
+    }
+    return { kind: 'apply' };
+}
+/** Map known CLI flags to prompt answers so we don't re-ask for them. */
+export function prefilledAnswers(options) {
+    const pre = {};
+    if (options.namespace)
+        pre.namespace = options.namespace;
+    if (options.componentName)
+        pre.componentName = options.componentName;
+    if (options.propertyType)
+        pre.propertyType = options.propertyType;
+    if (options.graph)
+        pre.graph = 'true';
+    return pre;
+}
+/** Run an artifact's prompts, skipping any already provided via flags. */
+export async function runArtifactPrompts(descriptor, projectName, options) {
+    const answers = prefilledAnswers(options);
+    for (const spec of descriptor.prompts) {
+        // Flag-supplied values bypass the prompt — validate them here so they don't
+        // slip past `spec.validate` (which inquirer only enforces interactively).
+        if (answers[spec.name] !== undefined) {
+            if (spec.validate) {
+                const result = spec.validate(answers[spec.name]);
+                if (result !== true) {
+                    console.error(chalk.red(`❌ ${result}`));
+                    process.exit(1);
+                }
+            }
+            continue;
+        }
+        if (spec.when && !spec.when(answers))
+            continue;
+        // The PCF component name defaults to a valid identifier derived from the project name.
+        const fallback = spec.default ?? (spec.name === 'componentName' ? toIdentifier(projectName) : undefined);
+        // Non-interactive: use the default; error if the prompt has none (needs a flag).
+        if (!process.stdin.isTTY) {
+            if (fallback === undefined) {
+                console.error(chalk.red(`❌ "${spec.name}" is required in non-interactive mode — provide the matching flag.`));
+                process.exit(1);
+            }
+            if (spec.validate) {
+                const result = spec.validate(fallback);
+                if (result !== true) {
+                    console.error(chalk.red(`❌ ${result}`));
+                    process.exit(1);
+                }
+            }
+            answers[spec.name] = fallback;
+            continue;
+        }
+        const reply = await inquirer.prompt([
+            {
+                type: spec.type ?? 'input',
+                name: spec.name,
+                message: spec.message,
+                // confirm prompts take a boolean default; our defaults are strings.
+                default: spec.type === 'confirm' ? fallback === 'true' : fallback,
+                choices: spec.choices,
+                validate: spec.validate,
+            },
+        ]);
+        answers[spec.name] = String(reply[spec.name]);
+    }
+    return answers;
+}
+/** Build the `{{var}}` substitution bag from answers + the artifact's derive() hook. */
+export function buildTemplateVariables(descriptor, projectName, answers, library, withComponents) {
+    let vars = { projectName, ...answers };
+    // Derived vars are data-driven per artifact (replaces hard-coded per-id logic).
+    if (descriptor.derive) {
+        vars = { ...vars, ...descriptor.derive(answers, { projectName }) };
+    }
+    if (descriptor.supportsLibraryChoice && library) {
+        vars.componentLibrary = library;
+    }
+    // Opt-in @khester/reusable-components (Fluent v8). Only honored on a host that
+    // can consume them; the driver guards `--with-components --v9` before this point.
+    if (descriptor.supportsComponents && withComponents) {
+        vars.withComponents = 'true';
+    }
+    // Always return the bag. Substitution is keyed on `{{name}}`, so it is a safe
+    // no-op on templates without placeholders — and this guarantees `{{projectName}}`
+    // is honored if a template adds it later (the old length-based guard silently skipped it).
+    return vars;
+}
+/** Resolve the artifact to scaffold from flags/prompts; handles legacy --template. */
+export async function resolveArtifact(options) {
+    // --template and --artifact are mutually exclusive (avoid one silently winning).
+    if (options.template && options.artifact) {
+        console.error(chalk.red('❌ --template (deprecated) and --artifact cannot be combined.') +
+            ` Use --artifact ${options.artifact}.`);
+        process.exit(1);
+    }
+    // Legacy --template flag: passthrough (power-pages) or hard-deprecate.
+    if (options.template) {
+        const migration = TEMPLATE_FLAG_MIGRATIONS[options.template];
+        if (!migration) {
+            console.error(chalk.red(`❌ Unknown --template "${options.template}".`) +
+                ` Use --artifact instead (one of: ${availableArtifacts().map((a) => a.id).join(', ')}).`);
+            process.exit(1);
+        }
+        if (migration.mode === 'hard-deprecate') {
+            console.error(chalk.yellow(`\n⚠️  --template ${options.template} has been removed in create-dynamics-app v${CLI_VERSION}.`) +
+                chalk.gray(`\n   The old flow generated entity/page/deployment code that is no longer shipped,` +
+                    `\n   so the output would differ from what you expect.\n`) +
+                chalk.cyan(`   Use:  create-dynamics-app <name> --artifact ${migration.artifact}\n`));
+            process.exit(1);
+        }
+        // passthrough
+        const descriptor = getArtifact(migration.artifact);
+        if (descriptor && descriptor.available) {
+            console.log(chalk.gray(`(note: --template ${options.template} is deprecated; prefer --artifact ${migration.artifact})`));
+            return descriptor;
+        }
+        console.error(chalk.red(`❌ Artifact "${migration.artifact}" is not available yet.`));
+        process.exit(1);
+    }
+    // Explicit --artifact flag.
+    if (options.artifact) {
+        const descriptor = getArtifact(options.artifact);
+        if (!descriptor || !descriptor.available) {
+            console.error(chalk.red(`❌ Unknown or unavailable artifact "${options.artifact}".`) +
+                ` Choose one of: ${availableArtifacts().map((a) => a.id).join(', ')}.`);
+            process.exit(1);
+        }
+        return descriptor;
+    }
+    // Interactive picker.
+    const { artifact } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'artifact',
+            message: 'What would you like to scaffold?',
+            choices: availableArtifacts().map((a) => ({ name: a.label, value: a.id })),
+        },
+    ]);
+    return getArtifact(artifact);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAOzD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAI,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAkBvF,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC;IACnC,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC;IACnC,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAgBD,MAAM,eAAe,GAAG,2DAA2D,CAAC;AAEpF,MAAM,UAAU,qBAAqB,CACnC,UAA8B,EAC9B,OAAqC,EACrC,cAAmC;IAEnC,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,qCAAqC,UAAU,CAAC,EAAE,iBAAiB,eAAe,GAAG;SAC/F,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EACL,qFAAqF,UAAU,CAAC,EAAE,KAAK;gBACvG,+CAA+C;SAClD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACzD,IAAI,OAAO,CAAC,aAAa;QAAE,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IACrE,IAAI,OAAO,CAAC,YAAY;QAAE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAClE,IAAI,OAAO,CAAC,KAAK;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA8B,EAC9B,WAAmB,EACnB,OAAuB;IAEvB,MAAM,OAAO,GAA2B,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAElE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,OAAuB,EAAE,CAAC;QACtD,4EAA4E;QAC5E,0EAA0E;QAC1E,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;oBACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QAE/C,uFAAuF;QACvF,MAAM,QAAQ,GACZ,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE1F,iFAAiF;QACjF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,oEAAoE,CAAC,CAC/F,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;oBACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YAClC;gBACE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO;gBAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,oEAAoE;gBACpE,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ;gBACjE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CACpC,UAA8B,EAC9B,WAAmB,EACnB,OAA+B,EAC/B,OAA0B,EAC1B,cAAwB;IAExB,IAAI,IAAI,GAA2B,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;IAE/D,gFAAgF;IAChF,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,UAAU,CAAC,qBAAqB,IAAI,OAAO,EAAE,CAAC;QAChD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,+EAA+E;IAC/E,kFAAkF;IAClF,IAAI,UAAU,CAAC,kBAAkB,IAAI,cAAc,EAAE,CAAC;QACpD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAC9E,kFAAkF;IAClF,2FAA2F;IAC3F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB;IAC3D,iFAAiF;IACjF,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,8DAA8D,CAAC;YACvE,mBAAmB,OAAO,CAAC,QAAQ,GAAG,CACzC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uEAAuE;IACvE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,yBAAyB,OAAO,CAAC,QAAQ,IAAI,CAAC;gBACtD,oCAAoC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC3F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CACV,oBAAoB,OAAO,CAAC,QAAQ,6CAA6C,WAAW,GAAG,CAChG;gBACC,KAAK,CAAC,IAAI,CACR,oFAAoF;oBAClF,yDAAyD,CAC5D;gBACD,KAAK,CAAC,IAAI,CAAC,kDAAkD,SAAS,CAAC,QAAQ,IAAI,CAAC,CACvF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,cAAc;QACd,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,UAAU,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,qBAAqB,OAAO,CAAC,QAAQ,qCAAqC,SAAS,CAAC,QAAQ,GAAG,CAChG,CACF,CAAC;YACF,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,SAAS,CAAC,QAAQ,yBAAyB,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,4BAA4B;IAC5B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,sCAAsC,OAAO,CAAC,QAAQ,IAAI,CAAC;gBACnE,mBAAmB,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sBAAsB;IACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACzC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,kCAAkC;YAC3C,OAAO,EAAE,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SAC3E;KACF,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,QAAQ,CAAE,CAAC;AAChC,CAAC"}

package/dist/templatePlan.d.ts

@@ -0,0 +1,3 @@
+import type { ArtifactDescriptor } from './artifacts/types.js';
+export declare function applyTemplatePlan(projectPath: string, descriptor: ArtifactDescriptor, vars: Record<string, string>): Promise<void>;
+//# sourceMappingURL=templatePlan.d.ts.map

package/dist/templatePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templatePlan.d.ts","sourceRoot":"","sources":["../src/templatePlan.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY/D,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/templatePlan.js

@@ -0,0 +1,43 @@
+/**
+ * Post-copy template plan: applies an artifact's `variants` (select one file per a
+ * derived key) and `prune` (delete scaffolding leftovers). Runs after `copyTemplate`
+ * has copied + substituted the whole template, so variant sources are already
+ * substituted before one is chosen.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/** Resolve a template-relative path, refusing anything that escapes the project dir. */
+function safeJoin(root, rel) {
+    const resolvedRoot = path.resolve(root);
+    const full = path.resolve(resolvedRoot, rel);
+    if (full !== resolvedRoot && !full.startsWith(resolvedRoot + path.sep)) {
+        throw new Error(`Path ${JSON.stringify(rel)} escapes the project directory.`);
+    }
+    return full;
+}
+export async function applyTemplatePlan(projectPath, descriptor, vars) {
+    // 1. Variant selection — pick one source file per the value of `choose`.
+    for (const variant of descriptor.variants ?? []) {
+        const key = vars[variant.choose];
+        if (key === undefined) {
+            throw new Error(`Variant selector "${variant.choose}" has no value — did the artifact's derive() set it?`);
+        }
+        const source = variant.cases[key];
+        if (source === undefined) {
+            throw new Error(`No variant case for ${variant.choose}=${JSON.stringify(key)} ` +
+                `(available: ${Object.keys(variant.cases).join(', ')}).`);
+        }
+        const from = safeJoin(projectPath, source);
+        const to = safeJoin(projectPath, variant.to);
+        if (!(await fs.pathExists(from))) {
+            throw new Error(`Variant source not found in template: ${source}`);
+        }
+        await fs.ensureDir(path.dirname(to));
+        await fs.copy(from, to, { overwrite: true });
+    }
+    // 2. Prune scaffolding leftovers (e.g. the _variants/ directory).
+    for (const rel of descriptor.prune ?? []) {
+        await fs.remove(safeJoin(projectPath, rel));
+    }
+}
+//# sourceMappingURL=templatePlan.js.map

package/dist/templatePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templatePlan.js","sourceRoot":"","sources":["../src/templatePlan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,wFAAwF;AACxF,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,UAA8B,EAC9B,IAA4B;IAE5B,yEAAyE;IACzE,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,qBAAqB,OAAO,CAAC,MAAM,sDAAsD,CAC1F,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,uBAAuB,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG;gBAC7D,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,kEAAkE;IAClE,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/utils/copyTemplate.d.ts

@@ -1,2 +1,14 @@
-export declare function copyTemplate(template: string, destinationPath: string): Promise<void>;
+/**
+ * Copy a template directory into the destination, then substitute `{{var}}`
+ * placeholders in file contents and filenames.
+ *
+ * `templateDir` is the LITERAL directory name under `templates/` (e.g.
+ * `react-custom-page`, `power-pages-starter`, `pcf-field`) — resolved from the
+ * artifact registry's `templateDir`, with no `-starter` suffix heuristic.
+ * Substitution runs whenever `templateVariables` is provided (no per-template
+ * special-casing).
+ */
+export declare function copyTemplate(templateDir: string, destinationPath: string, templateVariables?: {
+    [key: string]: string;
+}): Promise<void>;
 //# sourceMappingURL=copyTemplate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"copyTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"AASA,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}
+{"version":3,"file":"copyTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"AAuGA;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,iBAAiB,CAAC,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/utils/copyTemplate.js

@@ -5,19 +5,113 @@ import ora from 'ora';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-export async function copyTemplate(template, destinationPath) {
-    const spinner = ora(`Copying ${template} template...`).start();
+/** Substitution-variable keys must be plain identifiers (they go into a RegExp). */
+const KEY_PATTERN = /^[A-Za-z0-9_]+$/;
+/** Substitute `{{key}}` in a filename. Uses a function replacer so `$`-patterns in values are literal. */
+function substituteName(name, variables) {
+    if (!name.includes('{{'))
+        return name;
+    let out = name;
+    for (const [key, value] of Object.entries(variables)) {
+        out = out.replace(new RegExp(`{{${key}}}`, 'g'), () => value);
+    }
+    return out;
+}
+/** Rename `fullPath`'s basename to `newName`, refusing any name that escapes `dirPath`. */
+async function safeRename(dirPath, fullPath, newName) {
+    if (newName.includes('/') || newName.includes('\\') || newName.includes('..')) {
+        throw new Error(`Refusing unsafe substituted filename: ${JSON.stringify(newName)}`);
+    }
+    const newPath = path.join(dirPath, newName);
+    const resolvedDir = path.resolve(dirPath);
+    if (path.resolve(newPath) !== path.join(resolvedDir, newName)) {
+        throw new Error(`Substituted filename escapes the template directory: ${JSON.stringify(newName)}`);
+    }
+    await fs.rename(fullPath, newPath);
+}
+/**
+ * Restore dotfile names that npm strips from published tarballs. Templates ship
+ * these without the leading dot (e.g. `gitignore`) so they survive `npm publish`;
+ * we rename them back on copy. Runs for every scaffold, regardless of substitution.
+ */
+const DOTFILE_RENAMES = {
+    gitignore: '.gitignore',
+    npmignore: '.npmignore',
+};
+async function renameDotfiles(dirPath) {
+    for (const file of await fs.readdir(dirPath, { withFileTypes: true })) {
+        const fullPath = path.join(dirPath, file.name);
+        if (file.isDirectory()) {
+            await renameDotfiles(fullPath);
+        }
+        else if (DOTFILE_RENAMES[file.name]) {
+            await fs.rename(fullPath, path.join(dirPath, DOTFILE_RENAMES[file.name]));
+        }
+    }
+}
+async function replaceTemplateVariables(dirPath, variables) {
+    for (const key of Object.keys(variables)) {
+        if (!KEY_PATTERN.test(key)) {
+            throw new Error(`Invalid template variable key ${JSON.stringify(key)} (must match ${KEY_PATTERN}).`);
+        }
+    }
+    const files = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const file of files) {
+        const fullPath = path.join(dirPath, file.name);
+        if (file.isDirectory()) {
+            // Recurse first, then rename the directory if its name carries a placeholder.
+            await replaceTemplateVariables(fullPath, variables);
+            const newDirName = substituteName(file.name, variables);
+            if (newDirName !== file.name) {
+                await safeRename(dirPath, fullPath, newDirName);
+            }
+        }
+        else {
+            // Replace variables in file content. Function replacer => `$`-sequences in
+            // values are treated literally (no $&/$1 replacement-pattern injection).
+            let content = await fs.readFile(fullPath, 'utf8');
+            for (const [key, value] of Object.entries(variables)) {
+                const regex = new RegExp(`{{${key}}}`, 'g');
+                content = content.replace(regex, () => value);
+            }
+            await fs.writeFile(fullPath, content, 'utf8');
+            // Replace variables in filename if needed.
+            const newName = substituteName(file.name, variables);
+            if (newName !== file.name) {
+                await safeRename(dirPath, fullPath, newName);
+            }
+        }
+    }
+}
+/**
+ * Copy a template directory into the destination, then substitute `{{var}}`
+ * placeholders in file contents and filenames.
+ *
+ * `templateDir` is the LITERAL directory name under `templates/` (e.g.
+ * `react-custom-page`, `power-pages-starter`, `pcf-field`) — resolved from the
+ * artifact registry's `templateDir`, with no `-starter` suffix heuristic.
+ * Substitution runs whenever `templateVariables` is provided (no per-template
+ * special-casing).
+ */
+export async function copyTemplate(templateDir, destinationPath, templateVariables) {
+    const spinner = ora(`Copying ${templateDir} template...`).start();
     try {
-        const templatePath = path.join(__dirname, '../../templates', `${template}-starter`);
+        const templatePath = path.join(__dirname, '../../templates', templateDir);
         // Check if template exists
         if (!(await fs.pathExists(templatePath))) {
-            throw new Error(`Template ${template} not found at ${templatePath}`);
+            throw new Error(`Template ${templateDir} not found at ${templatePath}`);
         }
         // Copy all template files
         await fs.copy(templatePath, destinationPath, {
             overwrite: false,
             errorOnExist: false,
         });
+        // Replace template variables if provided
+        if (templateVariables) {
+            await replaceTemplateVariables(destinationPath, templateVariables);
+        }
+        // Restore npm-stripped dotfiles (gitignore → .gitignore) for every scaffold.
+        await renameDotfiles(destinationPath);
         spinner.succeed(chalk.green(`Template copied successfully`));
     }
     catch (error) {

package/dist/utils/copyTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyTemplate.js","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,eAAuB;IAEvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,QAAQ,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,SAAS,EACT,iBAAiB,EACjB,GAAG,QAAQ,UAAU,CACtB,CAAC;QAEF,2BAA2B;QAC3B,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,YAAY,QAAQ,iBAAiB,YAAY,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,0BAA0B;QAC1B,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE;YAC3C,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"copyTemplate.js","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"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"}

package/dist/utils/updatePackageJson.d.ts

@@ -1,2 +1,12 @@
-export declare function updatePackageJson(projectPath: string, projectName: string, clientName?: string): Promise<void>;
+/** Provenance stamped into a generated project's package.json for migration/debug. */
+export interface Provenance {
+    cliVersion: string;
+    artifact: string;
+    componentLibrary?: string;
+    templateVersion: string;
+}
+export interface UpdatePackageJsonOptions {
+    provenance?: Provenance;
+}
+export declare function updatePackageJson(projectPath: string, projectName: string, options?: UpdatePackageJsonOptions): Promise<void>;
 //# sourceMappingURL=updatePackageJson.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"updatePackageJson.d.ts","sourceRoot":"","sources":["../../src/utils/updatePackageJson.ts"],"names":[],"mappings":"AAKA,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"updatePackageJson.d.ts","sourceRoot":"","sources":["../../src/utils/updatePackageJson.ts"],"names":[],"mappings":"AAKA,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAoCf"}