@khester/create-dynamics-app 1.1.0 → 2.1.0

package/README.md

@@ -0,0 +1,74 @@
+# create-dynamics-app
+
+Unified CLI to scaffold Dynamics 365 / Power Platform artifacts — one tool, per-artifact templates, a Fluent **v8/v9** choice, integrated dev-tools, and an optional **from-design** mode.
+
+```bash
+create-dynamics-app <project-name> --artifact <id> [--v8|--v9]
+```
+
+## Quick start
+
+**Prerequisite:** Node 20+ (`engines.node >= 20`). Every package is public on npm — no login, no auth, no private registry.
+
+Scaffold a Dynamics **custom page** and run it (the scaffold step runs `npm install` for you):
+
+```bash
+npx @khester/create-dynamics-app my-custom-page --artifact react-custom-page --v8
+cd my-custom-page
+npm run dev      # webpack dev server + mock Xrm — open in the browser
+npm run build    # production bundle → dist/ (deployable web resource)
+```
+
+- Run with no flags (`npx @khester/create-dynamics-app my-custom-page`) for an interactive picker.
+- Use `--v9` for Fluent UI v9 (default is v8 — the safe choice for Power Pages / Dynamics).
+- Add `--with-components` to also install the [`@khester/reusable-components`](https://www.npmjs.com/package/@khester/reusable-components) Fluent v8 set (see Flags).
+- Pin a version (`@khester/create-dynamics-app@2.1.0`) for reproducible builds.
+
+### Connect to a live Dataverse org (optional)
+
+The scaffold ships dev-tools that pull real metadata. Needs the Azure CLI (`az login` into the tenant) **or** `DYNAMICS_*` env vars:
+
+```bash
+npm run auth:token                                   # az → token written to .env (git-ignored)
+npm run metadata:pull -- --entities account,contact  # live metadata → typed src/constants + src/models
+```
+
+## Artifacts (`--artifact`)
+
+| id | What it scaffolds | Fluent |
+|----|-------------------|--------|
+| `react-custom-page` | React SPA for a model-driven custom page | v8 |
+| `power-pages` | Power Pages portal starter | v8 |
+| `pcf-field` | PCF field control (property-type aware: text/number/boolean/date) | v8 |
+| `pcf-dataset` | PCF dataset/grid control (DetailsList) | v8 |
+| `grid-customizer` | Editable-grid cell-renderer customizer | v9 |
+| `web-resource` | React web resource (webpack bundle) | **v8 or v9** |
+| `dialog-form` | Single React form host (opened as a dialog) | **v8 or v9** |
+| `static-web-app` | Azure SWA — React frontend + Functions `api/` | **v8 or v9** |
+| `teams-app` | Teams tab (React + teams-js), optional Graph (`--graph`) | v9 |
+
+Run with no flags for an interactive picker.
+
+## Flags
+
+- `-a, --artifact <id>` — artifact to scaffold (see table).
+- `--v8` / `--v9` (or `-l, --library fluent-v8|fluent-v9`) — Fluent version for artifacts that support a choice. Only the chosen library is installed.
+- `-n, --namespace`, `--component-name`, `--property-type` — PCF options.
+- `--graph` — include Microsoft Graph (teams-app).
+- `--with-components` — install [`@khester/reusable-components`](https://www.npmjs.com/package/@khester/reusable-components) (a curated Fluent **v8** React set: `ReusableCard`, `CustomSection`, `FileUploadField`, `SearchComponent`, `DetailsListComponent`, the localhost-gated `logger`, …) plus its `@fluentui/react` v8 peer. Honored for the v8 React hosts — `react-custom-page`, `power-pages`, `web-resource`, `dialog-form`; warned-and-ignored elsewhere; **errors** if combined with `--v9`.
+- `--from-design <file>` — generate from a form-builder export (a `FormBuilderProject` JSON, e.g. from `/generate-form`). Wraps `@dataverse-kit/export-engine` to produce a deployable project (host + form code + a design-derived data layer). Supported targets: `web-resource`, `pcf`, `static-web-app`. From-design output is generated by the export engine and is structurally different from a blank starter (it ships its own token tooling); `package.json.dynamicsKit.artifact` records which.
+- `--skip-git`, `--skip-install`.
+
+## Dev-tools (in generated projects)
+
+Blank starters get `package.json` scripts for: `auth:token` (Azure CLI → `.env`), `metadata:pull` (typed entities via dvgen), `smoke:live` (live-org retrieve), plus a mock-Xrm helper for local serve.
+
+## Breaking changes in 2.0.0
+
+See `CHANGELOG.md`. In short: removed the consulting flags (`-c/-e/-p/-d/--generate-sample`); `--template dynamics-365|pcf-control` are removed (use `--artifact react-custom-page` / `--artifact pcf-field`); `--template power-pages` still works as a deprecated alias.
+
+## Testing & coverage boundaries
+
+- Unit + smoke tests (`npm test`) run the scaffold pipeline for all 9 artifacts (zero-residual-token + variant/prune checks) but do **not** `npm install` or build the generated projects.
+- React artifacts are verified to `tsc --noEmit` clean for v8 and v9 via manual installs; **PCF** type-correctness (against generated `ManifestTypes` from `pcf-scripts refreshTypes`) is verified manually, not in CI.
+- The `--from-design` generated-project build is verified manually.

package/dist/artifacts/registry.d.ts

@@ -0,0 +1,18 @@
+import type { ArtifactDescriptor, TemplateFlagMigration } from './types.js';
+/**
+ * The artifact registry. Phase 0 wires the three templates that exist today
+ * (`react-custom-page`, `power-pages`, `pcf-field`); the remaining artifacts
+ * are declared with `available: false` and their templates land in Phase A.
+ */
+export declare const ARTIFACTS: ArtifactDescriptor[];
+export declare function getArtifact(id: string): ArtifactDescriptor | undefined;
+export declare function availableArtifacts(): ArtifactDescriptor[];
+/**
+ * Legacy `--template <flag>` migration. `power-pages` is an honest passthrough
+ * (template unchanged). `dynamics-365` / `pcf-control` hard-deprecate: the old
+ * flows generated entity/page/deploy code (now removed) and PCF output changed,
+ * so silently remapping would break the published-CLI contract — we error out
+ * with migration guidance instead.
+ */
+export declare const TEMPLATE_FLAG_MIGRATIONS: Record<string, TemplateFlagMigration>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/artifacts/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/artifacts/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGlB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAoGpB;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,kBAAkB,EAwOzC,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAEzD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAI1E,CAAC"}

package/dist/artifacts/registry.js

@@ -0,0 +1,340 @@
+import { validateComponentName, validateNamespace, toIdentifier } from './validators.js';
+/**
+ * Fluent library dependency, added per the chosen componentLibrary so the
+ * generated project ships ONLY the version it uses (the v8/v9 choice is real,
+ * not cosmetic). The template base package.json carries neither Fluent package.
+ * `packagePath` targets the package.json that consumes Fluent (root, or an
+ * SWA's `frontend`).
+ */
+function fluentLibraryDeps(packagePath) {
+    return [
+        {
+            when: (vars) => vars.componentLibrary === 'fluent-v8',
+            dependencies: { '@fluentui/react': '^8.110.10' },
+            packagePath,
+        },
+        {
+            when: (vars) => vars.componentLibrary === 'fluent-v9',
+            dependencies: { '@fluentui/react-components': '^9.46.2' },
+            packagePath,
+        },
+    ];
+}
+/**
+ * Opt-in reusable component library (`--with-components`). It is Fluent v8, so it
+ * also pins the v8 peer — `pickHigherRange` dedupes that against `fluentLibraryDeps`
+ * on artifacts that also offer the v8/v9 choice. Gated on `vars.withComponents`,
+ * which the driver sets only for `supportsComponents` artifacts on a v8 build.
+ */
+function reusableComponentsDeps(packagePath) {
+    return [
+        {
+            when: (vars) => vars.withComponents === 'true',
+            dependencies: {
+                '@khester/reusable-components': '^0.1.0',
+                '@fluentui/react': '^8.110.10',
+            },
+            packagePath,
+        },
+    ];
+}
+/**
+ * PCF bound-property type → generated TypeScript value type, input-renderer variant,
+ * and the type-appropriate default used when reading `context.parameters.value.raw`.
+ */
+const PCF_TYPE_MAP = {
+    'SingleLine.Text': { tsType: 'string', renderKind: 'text', valueDefault: '""' },
+    'Whole.None': { tsType: 'number | null', renderKind: 'number', valueDefault: 'null' },
+    Decimal: { tsType: 'number | null', renderKind: 'number', valueDefault: 'null' },
+    OptionSet: { tsType: 'number | null', renderKind: 'number', valueDefault: 'null' },
+    TwoOptions: { tsType: 'boolean', renderKind: 'boolean', valueDefault: 'false' },
+    'DateAndTime.DateOnly': { tsType: 'Date | null', renderKind: 'date', valueDefault: 'null' },
+};
+/** Derive the common PCF naming vars (namespace / componentName / prefix). */
+function derivePcfNaming(answers, { projectName }) {
+    const namespace = answers.namespace || 'DynamicsUIKit';
+    const componentName = answers.componentName || toIdentifier(projectName);
+    return { namespace, componentName, prefix: namespace.toLowerCase() };
+}
+/** PCF field control: naming + property-type family (tsType/renderKind/valueDefault). */
+function derivePcfVars(answers, ctx) {
+    const propertyType = answers.propertyType || 'SingleLine.Text';
+    const family = PCF_TYPE_MAP[propertyType] ?? PCF_TYPE_MAP['SingleLine.Text'];
+    return {
+        ...derivePcfNaming(answers, ctx),
+        propertyType,
+        tsType: family.tsType,
+        renderKind: family.renderKind,
+        valueDefault: family.valueDefault,
+    };
+}
+/** Shared namespace/componentName prompts for PCF-family artifacts. */
+const PCF_NAMING_PROMPTS = [
+    {
+        name: 'namespace',
+        message: 'Namespace for the PCF control:',
+        type: 'input',
+        default: 'DynamicsUIKit',
+        validate: validateNamespace,
+    },
+    {
+        name: 'componentName',
+        message: 'Component name:',
+        type: 'input',
+        validate: validateComponentName,
+    },
+];
+/**
+ * The artifact registry. Phase 0 wires the three templates that exist today
+ * (`react-custom-page`, `power-pages`, `pcf-field`); the remaining artifacts
+ * are declared with `available: false` and their templates land in Phase A.
+ */
+export const ARTIFACTS = [
+    {
+        id: 'react-custom-page',
+        label: '⚡ React Custom Page — full React app mounted as a Dynamics 365 custom page',
+        description: 'Slim React SPA (models/services/components + dvgen dev-tools) for a model-driven app custom page.',
+        templateDir: 'react-custom-page',
+        supportsLibraryChoice: false,
+        supportsComponents: true,
+        // codegen is shipped in-template (tools/metadata-sync + metadata:* scripts), so only inject token.
+        devTools: ['token'],
+        prompts: [],
+        conditionalDeps: reusableComponentsDeps(),
+        exportTarget: 'static-web-app',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'power-pages',
+        label: '🌐 Power Pages — Power Pages portal starter',
+        description: 'Power Pages portal scaffold (ContactForm, providers, webpack).',
+        templateDir: 'power-pages-starter',
+        supportsLibraryChoice: false,
+        supportsComponents: true,
+        devTools: [],
+        prompts: [],
+        conditionalDeps: reusableComponentsDeps(),
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'pcf-field',
+        label: '🎛️  PCF Field Control — PowerApps Component Framework field control',
+        description: 'PCF field control (React + Fluent UI), built with pcf-scripts.',
+        templateDir: 'pcf-field',
+        supportsLibraryChoice: false,
+        devTools: [],
+        prompts: [
+            {
+                name: 'namespace',
+                message: 'Namespace for the PCF control:',
+                type: 'input',
+                default: 'DynamicsUIKit',
+                validate: validateNamespace,
+            },
+            {
+                // Default (= project name) is filled by the driver.
+                name: 'componentName',
+                message: 'Component name:',
+                type: 'input',
+                validate: validateComponentName,
+            },
+            {
+                name: 'propertyType',
+                message: 'Bound property type:',
+                type: 'list',
+                default: 'SingleLine.Text',
+                choices: [
+                    { name: 'Text (SingleLine.Text)', value: 'SingleLine.Text' },
+                    { name: 'Whole number (Whole.None)', value: 'Whole.None' },
+                    { name: 'Decimal (Decimal)', value: 'Decimal' },
+                    { name: 'Yes/No (TwoOptions)', value: 'TwoOptions' },
+                    { name: 'Option set (OptionSet)', value: 'OptionSet' },
+                    { name: 'Date (DateAndTime.DateOnly)', value: 'DateAndTime.DateOnly' },
+                ],
+                validate: (v) => v in PCF_TYPE_MAP
+                    ? true
+                    : `Unknown property type ${JSON.stringify(v)}. One of: ${Object.keys(PCF_TYPE_MAP).join(', ')}.`,
+            },
+        ],
+        derive: derivePcfVars,
+        // Pick the input renderer matching the property type, then drop the variant set.
+        variants: [
+            {
+                choose: 'renderKind',
+                cases: {
+                    text: '_variants/ValueInput.text.tsx',
+                    number: '_variants/ValueInput.number.tsx',
+                    boolean: '_variants/ValueInput.boolean.tsx',
+                    date: '_variants/ValueInput.date.tsx',
+                },
+                to: 'ValueInput.tsx',
+            },
+        ],
+        prune: ['_variants'],
+        exportTarget: 'pcf',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    // ----- Declared now, templates land in Phase A (not yet offered) -----
+    {
+        id: 'web-resource',
+        label: '📄 Web Resource — React (Fluent v8/v9) web resource',
+        description: 'Dynamics web resource: React + Fluent UI bundled to a single JS web resource.',
+        templateDir: 'web-resource',
+        supportsLibraryChoice: true,
+        supportsComponents: true,
+        defaultLibrary: 'fluent-v8',
+        devTools: ['token', 'serve', 'codegen'],
+        prompts: [],
+        // Select the Fluent v8 or v9 App shell based on the chosen component library.
+        variants: [
+            {
+                choose: 'componentLibrary',
+                cases: {
+                    'fluent-v8': '_variants/App.v8.tsx',
+                    'fluent-v9': '_variants/App.v9.tsx',
+                },
+                to: 'src/App.tsx',
+            },
+        ],
+        prune: ['_variants'],
+        conditionalDeps: [...fluentLibraryDeps(), ...reusableComponentsDeps()],
+        exportTarget: 'web-resource',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'pcf-dataset',
+        label: '🗂️  PCF Dataset Control — grid/dataset PCF control (Fluent v8)',
+        description: 'PCF dataset control: binds a grid/view, renders records with a DetailsList.',
+        templateDir: 'pcf-dataset',
+        supportsLibraryChoice: false,
+        devTools: [],
+        prompts: PCF_NAMING_PROMPTS,
+        derive: derivePcfNaming,
+        exportTarget: 'pcf',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'grid-customizer',
+        label: '🧩 Grid Customizer — editable-grid cell renderers (Fluent v9)',
+        description: 'Editable-grid customizer: map column types/names to Fluent v9 cell renderers.',
+        templateDir: 'grid-customizer',
+        supportsLibraryChoice: false,
+        devTools: [],
+        prompts: PCF_NAMING_PROMPTS,
+        derive: derivePcfNaming,
+        // No exportTarget: grid customizers use a separate export-engine generator,
+        // not the previewExport from-design path.
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'dialog-form',
+        label: '🪟 Dialog / Form — single React form (Fluent v8/v9) web-resource host',
+        description: 'Single-form host (opened as a dialog), React + Fluent UI. From-design capable.',
+        templateDir: 'dialog-form',
+        supportsLibraryChoice: true,
+        supportsComponents: true,
+        defaultLibrary: 'fluent-v8',
+        devTools: ['token', 'serve', 'codegen'],
+        prompts: [],
+        variants: [
+            {
+                choose: 'componentLibrary',
+                cases: {
+                    'fluent-v8': '_variants/App.v8.tsx',
+                    'fluent-v9': '_variants/App.v9.tsx',
+                },
+                to: 'src/App.tsx',
+            },
+        ],
+        prune: ['_variants'],
+        conditionalDeps: [...fluentLibraryDeps(), ...reusableComponentsDeps()],
+        exportTarget: 'web-resource',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'teams-app',
+        label: '💬 Teams App — Teams tab (React, Fluent v9, optional Graph)',
+        description: 'Microsoft Teams tab: React + Fluent v9 + teams-js, with optional Graph integration.',
+        templateDir: 'teams-app',
+        supportsLibraryChoice: false,
+        devTools: ['token', 'serve'],
+        prompts: [
+            {
+                name: 'graph',
+                message: 'Include Microsoft Graph integration?',
+                type: 'confirm',
+                default: 'false',
+            },
+        ],
+        // Map the Graph answer to a variant key for src/services/graph.ts.
+        derive: (answers) => ({ graphKind: answers.graph === 'true' ? 'on' : 'off' }),
+        variants: [
+            {
+                choose: 'graphKind',
+                cases: { on: '_variants/graph.on.ts', off: '_variants/graph.off.ts' },
+                to: 'src/services/graph.ts',
+            },
+        ],
+        prune: ['_variants'],
+        // Graph client is added only when Graph integration is enabled.
+        conditionalDeps: [
+            {
+                when: (vars) => vars.graphKind === 'on',
+                dependencies: { '@microsoft/microsoft-graph-client': '^3.0.7' },
+            },
+        ],
+        templateVersion: '2.0.0',
+        available: true,
+    },
+    {
+        id: 'static-web-app',
+        label: '☁️  Azure Static Web App — React frontend + managed Functions api/',
+        description: 'Azure SWA: React + Fluent UI (v8/v9) frontend with an Azure Functions api/.',
+        templateDir: 'static-web-app',
+        supportsLibraryChoice: true,
+        defaultLibrary: 'fluent-v9',
+        devTools: ['token', 'serve', 'codegen', 'smoke'],
+        prompts: [],
+        variants: [
+            {
+                choose: 'componentLibrary',
+                cases: {
+                    'fluent-v8': '_variants/App.v8.tsx',
+                    'fluent-v9': '_variants/App.v9.tsx',
+                },
+                to: 'frontend/src/App.tsx',
+            },
+        ],
+        prune: ['_variants'],
+        conditionalDeps: fluentLibraryDeps('frontend'),
+        exportTarget: 'static-web-app',
+        templateVersion: '2.0.0',
+        available: true,
+    },
+];
+export function getArtifact(id) {
+    return ARTIFACTS.find((a) => a.id === id);
+}
+export function availableArtifacts() {
+    return ARTIFACTS.filter((a) => a.available);
+}
+/**
+ * Legacy `--template <flag>` migration. `power-pages` is an honest passthrough
+ * (template unchanged). `dynamics-365` / `pcf-control` hard-deprecate: the old
+ * flows generated entity/page/deploy code (now removed) and PCF output changed,
+ * so silently remapping would break the published-CLI contract — we error out
+ * with migration guidance instead.
+ */
+export const TEMPLATE_FLAG_MIGRATIONS = {
+    'power-pages': { mode: 'passthrough', artifact: 'power-pages' },
+    'dynamics-365': { mode: 'hard-deprecate', artifact: 'react-custom-page' },
+    'pcf-control': { mode: 'hard-deprecate', artifact: 'pcf-field' },
+};
+//# sourceMappingURL=registry.js.map

package/dist/artifacts/registry.js.map

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

package/dist/artifacts/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Artifact registry types. The registry replaces the old hard-coded
+ * three-template `if/else` in `index.ts` — every scaffoldable artifact is one
+ * `ArtifactDescriptor`, and the CLI is a thin driver over the registry.
+ */
+/** Fluent UI version the generated React output targets. */
+export type ComponentLibrary = 'fluent-v8' | 'fluent-v9';
+/**
+ * export-engine target an artifact maps to for the (Phase B) from-design path.
+ * Mirrors the export engine's own ExportTarget — grid-customizer is NOT a
+ * from-design target (it uses a separate generator), so it carries no exportTarget.
+ */
+export type ExportTarget = 'web-resource' | 'pcf' | 'static-web-app';
+/** Dev-tools that `injectDevTools` (Phase A) can wire into a generated project. */
+export type DevToolId = 'token' | 'serve' | 'codegen' | 'smoke';
+/** The full set of artifact ids the unified CLI will produce. */
+export type ArtifactId = 'react-custom-page' | 'power-pages' | 'pcf-field' | 'pcf-dataset' | 'grid-customizer' | 'web-resource' | 'dialog-form' | 'teams-app' | 'static-web-app';
+/**
+ * A single interactive prompt for an artifact. The answer is written into the
+ * `{{name}}` substitution bag. `when` gates conditional prompts (e.g. a PCF
+ * property type only asked for field controls).
+ */
+export interface PromptSpec {
+    /** Substitution-variable key (also the inquirer answer name). */
+    name: string;
+    message: string;
+    type?: 'input' | 'list' | 'confirm';
+    default?: string;
+    choices?: Array<{
+        name: string;
+        value: string;
+    }>;
+    when?: (answers: Record<string, unknown>) => boolean;
+    /**
+     * Validate the answer. Returns `true` if valid, or an error message string.
+     * Enforced for BOTH the interactive prompt AND values supplied via flags
+     * (flags bypass the prompt, so a prompt-only validator would be insufficient).
+     */
+    validate?: (value: string) => true | string;
+}
+/**
+ * Select one file from a variant set based on the value of a (usually derived)
+ * substitution variable, then copy it to `to`. Lets a single template express
+ * divergent file bodies (e.g. a PCF control's input renderer per property type)
+ * without a separate template per case. `from`/`to` are template-relative paths.
+ */
+export interface VariantSelect {
+    /** Substitution-variable name whose value picks the case (e.g. 'renderKind'). */
+    choose: string;
+    /** value → source path within the template (e.g. { number: '_variants/input.number.tsx' }). */
+    cases: Record<string, string>;
+    /** Destination path the chosen case is copied to (e.g. 'src/ValueInput.tsx'). */
+    to: string;
+}
+/** Conditionally add dependencies to a generated package.json (e.g. Teams Graph). */
+export interface ConditionalDeps {
+    /** Predicate over the full substitution bag (answers + derived vars). */
+    when: (vars: Record<string, string>) => boolean;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    /** Project-relative directory of the target package.json (default: root). */
+    packagePath?: string;
+}
+export interface ArtifactDescriptor {
+    id: ArtifactId;
+    /** Display label for the interactive picker. */
+    label: string;
+    description: string;
+    /** Literal directory name under `templates/` (no suffix heuristic). */
+    templateDir: string;
+    /** Whether this artifact prompts for fluent-v8 vs fluent-v9 output. */
+    supportsLibraryChoice: boolean;
+    defaultLibrary?: ComponentLibrary;
+    /**
+     * Whether `--with-components` applies — i.e. this artifact is a Fluent-v8 React
+     * host that can consume `@khester/reusable-components`. When false/absent the
+     * flag is warned-and-ignored. Independent of `supportsLibraryChoice`: a v8-only
+     * host (react-custom-page, power-pages) has no library choice but still accepts
+     * the components; a v8/v9 host (web-resource, dialog-form) accepts them only on
+     * a v8 build (the driver errors on `--with-components --v9`).
+     */
+    supportsComponents?: boolean;
+    /** Dev-tools injected into the generated project (Phase A). */
+    devTools: DevToolId[];
+    /** Artifact-specific prompts → substitution variables. */
+    prompts: PromptSpec[];
+    /** export-engine target for the from-design path (Phase B); omitted = no from-design. */
+    exportTarget?: ExportTarget;
+    /**
+     * Derive additional substitution variables from the collected answers — the
+     * data-driven replacement for hard-coded per-id logic in the driver (e.g. a PCF
+     * control deriving `tsType`/`renderKind`/`prefix` from `propertyType`/`namespace`).
+     */
+    derive?: (answers: Record<string, string>, ctx: {
+        projectName: string;
+    }) => Record<string, string>;
+    /** File-variant selections applied after copy (e.g. property-type-specific renderer). */
+    variants?: VariantSelect[];
+    /** Template-relative files/dirs to delete after variant selection (scaffolding leftovers). */
+    prune?: string[];
+    /** Conditional dependency additions (consumed by injectDevTools/updatePackageJson). */
+    conditionalDeps?: ConditionalDeps[];
+    /** Template schema version, stamped into the generated package.json provenance. */
+    templateVersion: string;
+    /**
+     * Whether a template directory exists yet. Artifacts whose templates land in
+     * Phase A are declared here (for the type union + planning) but not offered
+     * until `available` flips true.
+     */
+    available: boolean;
+}
+/** How a legacy `--template <flag>` value migrates to the new artifact model. */
+export interface TemplateFlagMigration {
+    /**
+     * `passthrough` — the artifact is unchanged, run it (e.g. power-pages).
+     * `hard-deprecate` — print a notice and exit non-zero; output differs, so we
+     * never silently remap (would violate the published-CLI contract).
+     */
+    mode: 'passthrough' | 'hard-deprecate';
+    artifact: ArtifactId;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/artifacts/types.d.ts.map

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

package/dist/artifacts/types.js

@@ -0,0 +1,7 @@
+/**
+ * Artifact registry types. The registry replaces the old hard-coded
+ * three-template `if/else` in `index.ts` — every scaffoldable artifact is one
+ * `ArtifactDescriptor`, and the CLI is a thin driver over the registry.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/artifacts/validators.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ */
+export declare function validateComponentName(value: string): true | string;
+export declare function validateNamespace(value: string): true | string;
+/**
+ * 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 declare function toIdentifier(value: string): string;
+export declare function validateProjectName(value: string): true | string;
+//# sourceMappingURL=validators.d.ts.map

package/dist/artifacts/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/artifacts/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMhE"}