@khester/create-dynamics-app 2.10.0 → 3.1.0

package/dist/templatePlan.js

@@ -6,6 +6,23 @@
  */
 import fs from 'fs-extra';
 import path from 'path';
+/**
+ * Substitute `{{key}}` in a variant's `from`/`to` path.
+ *
+ * Needed because PCF templates put the control in a `{{componentName}}/` subfolder (the
+ * standard `pac pcf init` layout), while the `_variants/` pool stays at the project root
+ * so its paths remain static. So a variant reads from a fixed root path and writes into
+ * a per-scaffold directory: `to: '{{componentName}}/ValueInput.tsx'`.
+ */
+function substitutePath(rel, vars) {
+    if (!rel.includes('{{'))
+        return rel;
+    let out = rel;
+    for (const [key, value] of Object.entries(vars)) {
+        out = out.replace(new RegExp(`{{${key}}}`, 'g'), () => value);
+    }
+    return out;
+}
 /** Resolve a template-relative path, refusing anything that escapes the project dir. */
 function safeJoin(root, rel) {
     const resolvedRoot = path.resolve(root);
@@ -27,8 +44,8 @@ export async function applyTemplatePlan(projectPath, descriptor, vars) {
             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);
+        const from = safeJoin(projectPath, substitutePath(source, vars));
+        const to = safeJoin(projectPath, substitutePath(variant.to, vars));
         if (!(await fs.pathExists(from))) {
             throw new Error(`Variant source not found in template: ${source}`);
         }
@@ -37,7 +54,7 @@ export async function applyTemplatePlan(projectPath, descriptor, vars) {
     }
     // 2. Prune scaffolding leftovers (e.g. the _variants/ directory).
     for (const rel of descriptor.prune ?? []) {
-        await fs.remove(safeJoin(projectPath, rel));
+        await fs.remove(safeJoin(projectPath, substitutePath(rel, vars)));
     }
 }
 //# sourceMappingURL=templatePlan.js.map

package/dist/templatePlan.js.map

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

package/dist/utils/copyTemplate.d.ts

@@ -3,7 +3,7 @@
  * 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
+ * `react-custom-page`, `power-pages-island`, `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).

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

@@ -1 +1 @@
-{"version":3,"file":"copyTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"AA2HA;;;;;;;;;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"}
+{"version":3,"file":"copyTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/copyTemplate.ts"],"names":[],"mappings":"AA+HA;;;;;;;;;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

@@ -46,6 +46,10 @@ async function safeRename(dirPath, fullPath, newName) {
 const DOTFILE_RENAMES = {
     gitignore: '.gitignore',
     npmignore: '.npmignore',
+    // PCF templates: `pcf-scripts start` lints the control folder and dies with
+    // "No ESLint configuration found in <control>/" if none resolves. Shipped
+    // dotless for the same publish-safety reason as the two above.
+    'eslintrc.json': '.eslintrc.json',
 };
 async function renameDotfiles(dirPath) {
     for (const file of await fs.readdir(dirPath, { withFileTypes: true })) {
@@ -107,7 +111,7 @@ async function replaceTemplateVariables(dirPath, variables) {
  * 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
+ * `react-custom-page`, `power-pages-island`, `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).

package/dist/utils/copyTemplate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khester/create-dynamics-app",
-  "version": "2.10.0",
+  "version": "3.1.0",
   "license": "MIT",
   "description": "Unified CLI to scaffold Dynamics 365 / Power Platform artifacts",
   "main": "dist/index.js",

package/templates/_shared/dataverse-seam/XrmApiService.ts

@@ -2,10 +2,14 @@ import { IApiService } from "./IApiService";
 import { logCrud } from "./crudLogging";
 
 /**
- * Production API service for a model-driven custom page. Every call hits the
- * Dataverse Web API on the same origin (the hosting org authenticates the
- * request via its session), addressing entities by their SET name (e.g.
- * "accounts") so reads and writes use one consistent identifier.
+ * Production API service for an app hosted INSIDE a model-driven app — an HTML web resource on a
+ * form or behind a sitemap SubArea, or a PCF control. Every call hits the Dataverse Web API on the
+ * same origin (the hosting org authenticates via its session), addressing entities by their SET
+ * name (e.g. "accounts") so reads and writes use one consistent identifier.
+ *
+ * NOT for a Power Apps *custom page* hosted standalone: this class needs an `Xrm` object, and a
+ * canvasapp does not provide one. To put a component in a real custom page, use a PCF control —
+ * `context.webAPI`, or (verified live 2026-07-25) a same-origin fetch, both work there.
  */
 export class XrmApiService implements IApiService {
   private Xrm: any;
@@ -15,8 +19,25 @@ export class XrmApiService implements IApiService {
     this.Xrm = Xrm;
   }
 
+  /**
+   * Resolve the org URL. `Xrm.Utility.getGlobalContext()` is the supported API and is available in
+   * every model-driven host; `Xrm.Page` is deprecated and only exists on a FORM, so it is a fallback
+   * rather than the primary. Both are probed defensively: reaching straight for
+   * `Xrm.Page.context.getClientUrl()` throws a bare `TypeError` when the app is opened outside a form
+   * (e.g. the raw /WebResources/ URL), which tells the developer nothing about the actual cause.
+   */
   private clientUrl(): string {
-    return this.Xrm.Page.context.getClientUrl();
+    const url =
+      this.Xrm?.Utility?.getGlobalContext?.()?.getClientUrl?.() ??
+      this.Xrm?.Page?.context?.getClientUrl?.();
+    if (!url) {
+      throw new Error(
+        "Could not resolve the Dataverse client URL from the Xrm object. This app must run inside a " +
+          "model-driven app (a web resource on a form or a sitemap SubArea). Opening the web resource " +
+          "URL directly gives it no parent Xrm.",
+      );
+    }
+    return url;
   }
 
   private headers(): HeadersInit {

package/templates/host-swap/README.md

@@ -1,7 +1,9 @@
 # {{projectName}} — host-swap component
 
 One React component, written once against an injected `IApiService`, that you can
-host as a **PCF control**, a **Dynamics 365 custom page**, or a **web resource**.
+host as a **PCF control** or as a **web resource** (in two flavours — webpack, or Vite under the
+legacy `custom-page` host name; ★ despite the name that host emits an HTML web resource, NOT a
+Power Apps custom page — for a real one, use `--host pcf` and drop the control on the page).
 You chose the host at scaffold time (`--host pcf`, `--host custom-page`, or
 `--host web-resource`); to retarget, scaffold again with another host and copy your
 `src/Component.tsx` across — the component never changes, only the thin wrapper does.
@@ -17,7 +19,7 @@ You chose the host at scaffold time (`--host pcf`, `--host custom-page`, or
 
 ## How each host supplies the data service
 
-- **Custom page (Vite):** `App.tsx` resolves the Xrm context and `ServiceFactory`
+- **`custom-page` host (Vite web resource):** `App.tsx` resolves the Xrm context and `ServiceFactory`
   picks Mock (localhost), the token-proxy (`npm run dev` with `DYNAMICS_URL`), or
   the production `XrmApiService` (deployed).
 - **PCF control (pcf-scripts):** the control builds the service directly — a
@@ -36,3 +38,56 @@ npm install
 # pcf:          npm run build   (pcf-scripts build)    |  npm start     (PCF test harness)
 # web-resource: npm run build   (webpack --mode production) | npm run dev (webpack dev server)
 ```
+
+> ★ **`pcf-scripts build` exits 0 even when the build FAILS.** If you script this in CI, grep the
+> log for `[build] Succeeded` and for the absence of `compiled with N errors` — don't trust `$?`.
+
+## Deploy
+
+The three hosts are **not** symmetric here. Only the PCF host has a first-class deploy path.
+
+### PCF
+
+```bash
+pac pcf push --publisher-prefix <your-prefix>
+```
+
+Builds, wraps the control in a temporary `PowerAppsToolsTemp_<prefix>` solution, imports it and
+publishes. This needs the `.pcfproj` this template ships; its `ProjectGuid` is generated per
+scaffold, so two controls from this template never collide inside one solution.
+
+To ship versioned **managed + unmanaged** solution zips instead of a temp solution, wrap the
+control in a solution project and build that:
+
+```bash
+pac solution init --publisher-name <you> --publisher-prefix <p>
+pac solution add-reference --path .
+dotnet build -c Release -p:SolutionPackageType=Both
+pac solution import --path bin/Release/<Solution>.zip
+```
+
+(If you have the `claude-workspace` checkout, `msft/04-dynamics/scripts/deploy/package-control.sh
+--source . --version 1.0.0 --output ./dist` automates exactly that — it discards this `.pcfproj`
+and generates its own, so the two paths never conflict.)
+
+★ **Bump `ControlManifest.Input.xml`'s `version=` on every change.** Neither command does it for
+you, and without a bump the platform serves the cached previous build — the single most common
+"my fix didn't deploy".
+
+★ **The `<platform-library>` versions must be exact.** `pcf-scripts` matches a *range* and
+silently remaps the bundle, but leaves your number in the manifest — so a wrong version **builds
+green and fails to load in every host**. React must be `16.14.0`; Fluent `@fluentui/react` must be
+`8.29.0` or `8.121.1`.
+
+### Web resource
+
+No deploy script ships. Build, then upload `dist/` as a JavaScript web resource — via the maker
+portal, `pac webresource push`, or the workspace's `webresource-manager.sh` if you have that
+checkout — and reference it from a form or the sitemap.
+
+### Custom page
+
+★ **No deploy path ships for this host.** Despite the name it emits a Vite-built **HTML web
+resource**, not a Power Apps custom page — see the registry description. If you want an uploader,
+the `react-custom-page` artifact has one (`tools/deploy/deploy-webresource.cjs`); if you want a
+*real* model-driven custom page, use `--host pcf` and drop the control onto the page in Studio.

package/templates/host-swap/_variants/host.custom-page/src/App.tsx

@@ -1,14 +1,18 @@
 import * as React from "react";
 import { ServiceFactory } from "./core/services/ServiceFactory";
 import { Component } from "./Component";
+import { useHostWidth } from "./useHostWidth";
 
-// Resolve the Xrm context when hosted as a Dynamics custom page (the app runs in
-// an iframe → window.parent.Xrm, or window.Xrm). ServiceFactory then picks the
-// IApiService per environment: Mock on localhost, the token-proxy in dev, or the
-// production XrmApiService when deployed.
+// Resolve the Xrm context. This host is an HTML WEB RESOURCE (not a Power Apps
+// custom page): it runs in an iframe inside a model-driven app, so Xrm comes from
+// window.parent. ServiceFactory then picks the IApiService per environment: Mock on
+// localhost, the token-proxy in dev, or the production XrmApiService when deployed.
 const Xrm = (window.parent as any)?.Xrm ?? (window as any).Xrm;
 
 export const App: React.FC = () => {
   const api = React.useMemo(() => ServiceFactory.createApiService(Xrm), []);
-  return <Component api={api} />;
+  // Embedded in a form iframe this is often narrow on a phone, so measure rather
+  // than assume desktop.
+  const width = useHostWidth();
+  return <Component api={api} width={width} />;
 };

package/templates/host-swap/_variants/host.pcf/ControlManifest.Input.xml

@@ -6,8 +6,32 @@
     <property name="value" display-name-key="value_Display_Key" description-key="value_Desc_Key" of-type="SingleLine.Text" usage="bound" required="false" />
     <resources>
       <code path="index.ts" order="1"/>
-      <platform-library name="React" version="18.2.0" />
-      <platform-library name="Fluent" version="8.115.6" />
+      <!--
+        ★ These versions MUST come from Microsoft's supported platform-library list; arbitrary
+        versions do not fail the build, they fail the RUNTIME. `pcf-scripts` silently maps an
+        unsupported version to the nearest supported one when bundling (8.115.6 was emitted as
+        `external "FluentUIReactv81211"`), but the MANIFEST keeps the number the platform then
+        cannot resolve — so the control builds green and renders "Error loading control" in every
+        host. Live-diagnosed 2026-07-26: this template previously declared React 18.2.0 + Fluent
+        8.115.6, neither of which is supported, and could not load in a form OR a custom page.
+        Supported (learn.microsoft.com/power-apps/developer/component-framework/react-controls-platform-libraries):
+          React  → 16.14.0 only (the platform loads 17.0.2 in model-driven, 16.14.0 in canvas)
+          Fluent → @fluentui/react 8.29.0 or 8.121.1; @fluentui/react-components >=9.4.0 <=9.46.2
+        v8 and v9 cannot both be declared in one manifest.
+
+        ★ The rule is EQUALITY, not range membership. pcf-scripts matches a supported
+        {minVersion, maxVersion} range and remaps the bundle to that row's platformVersion,
+        but never rewrites this file — so a version inside the range yet unequal to its
+        platformVersion builds green and cannot be resolved at runtime. Asserted in
+        src/__tests__/registry.test.ts.
+
+        ★ package.json intentionally carries react@^18 while this says 16.14.0: the shared
+        dataverse-seam pulls @khester/reusable-components, whose peer is react>=17. So the
+        types will NOT stop you writing a React 18 API that crashes only in a custom page
+        (canvas serves 16.14.0). Don't. See package.json `_comment_versions`.
+      -->
+      <platform-library name="React" version="16.14.0" />
+      <platform-library name="Fluent" version="8.121.1" />
       <resx path="strings/{{componentName}}.1033.resx" version="1.0.0" />
     </resources>
     <feature-usage>

package/templates/host-swap/_variants/host.pcf/gitignore

@@ -3,3 +3,10 @@ out/
 generated/
 *.log
 .env
+
+# MSBuild output from the .pcfproj (`pac pcf push` / `dotnet build`). Without these
+# the first push litters an untracked obj/PowerAppsToolsTemp_* tree into the repo.
+bin/
+obj/
+*.binlog
+.vs/

package/templates/host-swap/_variants/host.pcf/index.ts

@@ -15,12 +15,18 @@ import { MockApiService } from "./src/core/services/MockApiService";
  * the session cookie — no Xrm or clientUrl needed. On localhost (the pcf-scripts
  * test harness) it falls back to the in-memory mock so the control renders with
  * no org.
+ *
+ * ★ This holds in a model-driven CUSTOM PAGE too — verified live 2026-07-25: a
+ * custom page reports the org origin (not apps.powerapps.com) and a same-origin
+ * fetch returns 200, in a desktop browser and in the native Power Apps iOS app.
+ * That is observed behaviour rather than a documented contract, so if it ever
+ * regresses, swap this line for `context.webAPI` (the API Microsoft documents).
  */
 export class {{componentName}} implements ComponentFramework.ReactControl<IInputs, IOutputs> {
   private api!: IApiService;
 
   public init(
-    _context: ComponentFramework.Context<IInputs>,
+    context: ComponentFramework.Context<IInputs>,
     _notifyOutputChanged: () => void,
     _state: ComponentFramework.Dictionary,
   ): void {
@@ -28,10 +34,22 @@ export class {{componentName}} implements ComponentFramework.ReactControl<IInput
       typeof window !== "undefined" &&
       /^(localhost|127\.0\.0\.1)$/.test(window.location.hostname);
     this.api = onLocalhost ? new MockApiService() : new FetchApiService("");
+
+    // Opt in to container-size reporting. WITHOUT THIS `allocatedWidth` never
+    // updates, so the control cannot respond to the device or to a resize — the
+    // usual reason a "responsive" PCF silently isn't.
+    context.mode.trackContainerResize(true);
   }
 
-  public updateView(_context: ComponentFramework.Context<IInputs>): React.ReactElement {
-    return React.createElement(Component, { api: this.api });
+  public updateView(context: ComponentFramework.Context<IInputs>): React.ReactElement {
+    // Pass the measured width down. Do NOT use context.client.getFormFactor():
+    // verified live on a physical iPhone in the native Power Apps app, a custom
+    // page reports formFactor 1 (Desktop) and client "Web", so form-factor
+    // branching hands every phone the desktop layout.
+    return React.createElement(Component, {
+      api: this.api,
+      width: context.mode.allocatedWidth,
+    });
   }
 
   public getOutputs(): IOutputs {

package/templates/host-swap/_variants/host.pcf/package.json

@@ -1,7 +1,7 @@
 {
   "name": "{{projectName}}",
   "version": "1.0.0",
-  "description": "{{componentName}} — host-swap component hosted as a PCF control",
+  "description": "{{componentName}} \u2014 host-swap component hosted as a PCF control",
   "scripts": {
     "build": "pcf-scripts build",
     "clean": "pcf-scripts clean",
@@ -9,8 +9,24 @@
     "start": "pcf-scripts start",
     "refreshTypes": "pcf-scripts refreshTypes"
   },
+  "_comment_versions": [
+    "\u2605 @fluentui/react is PINNED EXACTLY to the <platform-library> version in",
+    "ControlManifest.Input.xml and must move with it. This is a VIRTUAL control: react, react-dom",
+    "and @fluentui/react are externalized by pcf-scripts and supplied by the platform at runtime \u2014",
+    "and by pcf-start in the harness \u2014 so none of them reaches the bundle. That makes the version a",
+    "TYPES decision: the compiler should see the API the platform will actually serve. A caret",
+    "defeats it \u2014 ^8.120.0 resolved to 8.125.7 while the platform served 8.121.1.",
+    "",
+    "\u2605 react/react-dom stay at ^18 on purpose: pinning them to the manifest's 16.14.0 fails",
+    "npm install ERESOLVE, because the shared dataverse-seam imports @khester/reusable-components",
+    "(peer react>=17). But the @types ARE pinned to 16, which is what actually matters here \u2014 the",
+    "canvas runtime behind a custom page serves React 16.14.0, so useId/useTransition/",
+    "useSyncExternalStore must be a COMPILE error rather than a crash that only reproduces on a",
+    "phone. Since nothing from these packages is bundled, the runtime versions are inert and the",
+    "types carry the contract."
+  ],
   "dependencies": {
-    "@fluentui/react": "^8.120.0",
+    "@fluentui/react": "8.121.1",
     "@types/powerapps-component-framework": "^1.3.18",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
@@ -18,8 +34,8 @@
   "devDependencies": {
     "@microsoft/eslint-config-spfx": "^1.18.2",
     "@types/node": "^18.16.9",
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
+    "@types/react": "^16.14.0",
+    "@types/react-dom": "^16.9.0",
     "eslint-plugin-react-hooks": "^4.6.0",
     "pcf-scripts": "^1",
     "pcf-start": "^1",

package/templates/host-swap/_variants/host.pcf/{{componentName}}.pcfproj

@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  MSBuild project for the PCF control. Without this file `pac pcf push` fails
+  outright, so a scaffolded control has no deploy path at all — which is exactly
+  what this template shipped before.
+
+  Two ways to deploy (see the README's Deploy section):
+    • pac pcf push --publisher-prefix <p>   — fastest dev loop; wraps the control
+      in a temporary PowerAppsToolsTemp_<p> solution and imports it.
+    • package-control.sh --source <dir>     — emits versioned managed/unmanaged
+      solution zips with no temp solution. That script DISCARDS this file and
+      generates its own, so the two never conflict.
+
+  ProjectGuid is generated per scaffold, so two controls from this template never collide
+  inside one solution.
+-->
+<Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <PowerAppsTargetsPath>$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\PowerApps</PowerAppsTargetsPath>
+  </PropertyGroup>
+
+  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" />
+  <Import Project="$(PowerAppsTargetsPath)\Microsoft.PowerApps.VisualStudio.Pcf.props" Condition="Exists('$(PowerAppsTargetsPath)\Microsoft.PowerApps.VisualStudio.Pcf.props')" />
+
+  <PropertyGroup>
+    <Name>{{componentName}}</Name>
+    <ProjectGuid>{{{projectGuid}}}</ProjectGuid>
+    <OutputPath>$(MSBuildThisFileDirectory)out\controls</OutputPath>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <TargetFrameworkVersion>v4.6.2</TargetFrameworkVersion>
+    <TargetFramework>net462</TargetFramework>
+    <RestoreProjectStyle>PackageReference</RestoreProjectStyle>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.PowerApps.MSBuild.Pcf" Version="1.*" />
+    <!-- Supplies the net462 reference assemblies on macOS/Linux so this builds
+         without a Windows image (otherwise MSB3644). -->
+    <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\.gitignore" />
+    <!-- A scaffolded project always has a nested .git (initGit runs unless --skip-git); the
+         probe this was modelled on lives inside a repo and never had one. package-control.sh
+         rm -rf's it before building, which is the same signal. -->
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\.git\**" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\.vs\**" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\bin\**" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\obj\**" />
+    <ExcludeDirectories Include="$(OutputPath)\**" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\*.pcfproj" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\*.pcfproj.user" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\*.sln" />
+    <ExcludeDirectories Include="$(MSBuildThisFileDirectory)\node_modules\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="$(MSBuildThisFileDirectory)\**" Exclude="@(ExcludeDirectories)" />
+  </ItemGroup>
+
+  <Import Project="$(MSBuildToolsPath)\Microsoft.Common.targets" />
+  <Import Project="$(PowerAppsTargetsPath)\Microsoft.PowerApps.VisualStudio.Pcf.targets" Condition="Exists('$(PowerAppsTargetsPath)\Microsoft.PowerApps.VisualStudio.Pcf.targets')" />
+
+</Project>

package/templates/host-swap/_variants/host.web-resource/src/App.tsx

@@ -3,6 +3,7 @@ import type { IApiService } from "./core/services/IApiService";
 import { FetchApiService } from "./core/services/FetchApiService";
 import { MockApiService } from "./core/services/MockApiService";
 import { Component } from "./Component";
+import { useHostWidth } from "./useHostWidth";
 
 // A web resource is served from the org origin, so a same-origin relative
 // /api/data/v9.2 fetch is authenticated by the session cookie — no Xrm or
@@ -14,5 +15,8 @@ export const App: React.FC = () => {
     const onLocalhost = /^(localhost|127\.0\.0\.1)$/.test(window.location.hostname);
     return onLocalhost ? new MockApiService() : new FetchApiService("");
   }, []);
-  return <Component api={api} />;
+  // A web resource embedded on a form is often narrow on a phone, so measure the
+  // viewport rather than assuming desktop.
+  const width = useHostWidth();
+  return <Component api={api} width={width} />;
 };

package/templates/host-swap/src/Component.tsx

@@ -17,14 +17,33 @@ initializeIcons();
 
 /**
  * The ONE host-agnostic component. It depends on nothing but an injected
- * `IApiService` — no PCF `context`, no Xrm, no lifecycle, no bundler globals — so
- * the SAME source renders unchanged inside a PCF control and a Dynamics custom
- * page. Each host's thin wrapper builds the right `IApiService` and mounts this.
+ * `IApiService` and a plain number for its width — no PCF `context`, no Xrm, no
+ * lifecycle, no bundler globals — so the SAME source renders unchanged inside a
+ * PCF control, a web resource, and a model-driven custom page. Each host's thin
+ * wrapper builds the right `IApiService` and supplies the width.
  */
 export interface ComponentProps {
   api: IApiService;
+  /**
+   * Width available to the control, in px. Hosts that can measure it should pass it
+   * (the PCF wrapper passes `context.mode.allocatedWidth`); when omitted the layout
+   * falls back to the roomy variant.
+   *
+   * ★ Deliberately a NUMBER, not a form factor. Do NOT branch on
+   * `context.client.getFormFactor()` / `getClient()`: verified live 2026-07-25 on a
+   * physical iPhone in the native Power Apps app, a custom page reports
+   * client "Web" and formFactor 1 (Desktop). Branching on those silently gives every
+   * phone the desktop layout, and passes every test not run on a real device.
+   */
+  width?: number;
 }
 
+/**
+ * Below this the Fluent `DetailsList` stops being usable — columns collapse and
+ * horizontal scrolling takes over — so narrow hosts get a stacked card list instead.
+ */
+const NARROW_BREAKPOINT_PX = 480;
+
 const ACCOUNTS_FETCHXML = [
   '<fetch top="25">',
   '  <entity name="account">',
@@ -47,10 +66,14 @@ const COLUMNS: IColumn[] = [
   { key: "telephone1", name: "Phone", fieldName: "telephone1", minWidth: 140, isResizable: true },
 ];
 
-export const Component: React.FC<ComponentProps> = ({ api }) => {
+export const Component: React.FC<ComponentProps> = ({ api, width }) => {
   const [rows, setRows] = React.useState<AccountRow[] | null>(null);
   const [error, setError] = React.useState<string | null>(null);
 
+  // `width === undefined` means the host cannot measure itself; prefer the roomy
+  // layout rather than guessing narrow.
+  const isNarrow = width !== undefined && width < NARROW_BREAKPOINT_PX;
+
   React.useEffect(() => {
     let cancelled = false;
     api
@@ -70,12 +93,13 @@ export const Component: React.FC<ComponentProps> = ({ api }) => {
     <Stack tokens={{ childrenGap: 12 }} styles={{ root: { padding: 16 } }}>
       <Text variant="xLarge">Accounts</Text>
       <Text variant="small">
-        One host-agnostic component — the same source renders in a PCF control and a
-        Dynamics custom page; only the thin host wrapper changes.
+        One host-agnostic component — the same source renders in a PCF control, a web
+        resource and a model-driven custom page; only the thin host wrapper changes.
+        {width !== undefined && ` (${isNarrow ? "narrow" : "wide"} layout · ${width}px)`}
       </Text>
       {error && <MessageBar messageBarType={MessageBarType.error}>{error}</MessageBar>}
       {!rows && !error && <Spinner label="Loading accounts…" />}
-      {rows && (
+      {rows && !isNarrow && (
         <DetailsList
           items={rows}
           columns={COLUMNS}
@@ -84,6 +108,29 @@ export const Component: React.FC<ComponentProps> = ({ api }) => {
           selectionMode={SelectionMode.none}
         />
       )}
+      {rows && isNarrow && (
+        <Stack tokens={{ childrenGap: 8 }}>
+          {rows.map((row) => (
+            <Stack
+              key={row.accountid}
+              tokens={{ childrenGap: 2 }}
+              styles={{
+                root: {
+                  padding: 12,
+                  border: "1px solid #edebe9",
+                  borderRadius: 4,
+                  // Long account names must wrap rather than force the card wider
+                  // than the phone — the failure mode DetailsList has here.
+                  wordBreak: "break-word",
+                },
+              }}
+            >
+              <Text variant="mediumPlus">{row.name ?? "(no name)"}</Text>
+              <Text variant="small">{row.telephone1 ?? "—"}</Text>
+            </Stack>
+          ))}
+        </Stack>
+      )}
     </Stack>
   );
 };