@salesforce/templates 66.3.3 → 66.4.0

package/lib/templates/project/reactb2x/scripts/setup-cli.mjs

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+/**
+ * One-command setup: login, deploy, optional permset/data, GraphQL schema/codegen, web app build.
+ * Use this script to make setup easier for each app generated from this template.
+ *
+ * Usage:
+ *   node scripts/setup-cli.mjs --target-org <alias>   # run all steps
+ *   node scripts/setup-cli.mjs --target-org afv5 --skip-login
+ *   node scripts/setup-cli.mjs --target-org afv5 --skip-data --skip-webapp-build
+ *   node scripts/setup-cli.mjs --target-org myorg --webapp-name my-app
+ *
+ * Steps (in order):
+ *   1. login     — sf org login web only if org not already connected (skip with --skip-login)
+ *   2. deploy    — sf project deploy start --target-org <alias>
+ *   3. permset   — sf org assign permset (skip with --skip-permset; name via --permset-name)
+ *   4. data      — prepare unique fields + sf data import tree (skipped if no data dir/plan)
+ *   5. graphql   — (in webapp) npm run graphql:schema then npm run graphql:codegen
+ *   6. webapp    — (in webapp) npm install && npm run build
+ *   7. dev       — (in webapp) npm run dev — launch dev server (skip with --skip-dev)
+ */
+
+import { spawnSync } from 'node:child_process';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readdirSync, existsSync } from 'node:fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const WEBAPPLICATIONS_DIR = resolve(ROOT, 'force-app/main/default/webapplications');
+const DATA_DIR = resolve(ROOT, 'force-app/main/default/data');
+const DATA_PLAN = resolve(ROOT, 'force-app/main/default/data/data-plan.json');
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let targetOrg = null;
+  let webappName = null;
+  let permsetName = 'Property_Management_Access';
+  const flags = {
+    skipLogin: false,
+    skipDeploy: false,
+    skipPermset: false,
+    skipData: false,
+    skipGraphql: false,
+    skipWebappBuild: false,
+    skipDev: false,
+  };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--target-org' && args[i + 1]) {
+      targetOrg = args[++i];
+    } else if (args[i] === '--webapp-name' && args[i + 1]) {
+      webappName = args[++i];
+    } else if (args[i] === '--permset-name' && args[i + 1]) {
+      permsetName = args[++i];
+    } else if (args[i] === '--skip-login') flags.skipLogin = true;
+    else if (args[i] === '--skip-deploy') flags.skipDeploy = true;
+    else if (args[i] === '--skip-permset') flags.skipPermset = true;
+    else if (args[i] === '--skip-data') flags.skipData = true;
+    else if (args[i] === '--skip-graphql') flags.skipGraphql = true;
+    else if (args[i] === '--skip-webapp-build') flags.skipWebappBuild = true;
+    else if (args[i] === '--skip-dev') flags.skipDev = true;
+    else if (args[i] === '--help' || args[i] === '-h') {
+      console.log(`
+Setup CLI — one-command setup for apps in this project
+
+Usage:
+  node scripts/setup-cli.mjs --target-org <alias> [options]
+
+Required:
+  --target-org <alias>   Target Salesforce org alias (e.g. myorg)
+
+Options:
+  --webapp-name <name>   Web app folder name under webapplications/ (default: auto-detect)
+  --permset-name <name>  Permission set to assign (default: Property_Management_Access)
+  --skip-login           Skip login step (login is auto-skipped if org is already connected)
+  --skip-deploy          Do not deploy metadata
+  --skip-permset         Do not assign permission set
+  --skip-data            Do not prepare data or run data import
+  --skip-graphql         Do not fetch schema or run GraphQL codegen
+  --skip-webapp-build    Do not npm install / build the web application
+  --skip-dev             Do not launch the dev server at the end
+  -h, --help             Show this help
+`);
+      process.exit(0);
+    }
+  }
+  if (!targetOrg) {
+    console.error('Error: --target-org <alias> is required.');
+    process.exit(1);
+  }
+  return { targetOrg, webappName, permsetName, ...flags };
+}
+
+function discoverWebappDir(webappName) {
+  if (webappName) {
+    const dir = resolve(WEBAPPLICATIONS_DIR, webappName);
+    if (!existsSync(dir)) {
+      console.error(`Error: Web app directory not found: ${dir}`);
+      process.exit(1);
+    }
+    return dir;
+  }
+  if (!existsSync(WEBAPPLICATIONS_DIR)) {
+    console.error(`Error: webapplications directory not found: ${WEBAPPLICATIONS_DIR}`);
+    process.exit(1);
+  }
+  const entries = readdirSync(WEBAPPLICATIONS_DIR, { withFileTypes: true });
+  const dirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith('.'));
+  if (dirs.length === 0) {
+    console.error(`Error: No web app folder found under ${WEBAPPLICATIONS_DIR}`);
+    process.exit(1);
+  }
+  if (dirs.length > 1) {
+    console.log(`Multiple web apps found; using first: ${dirs[0].name}`);
+  }
+  return resolve(WEBAPPLICATIONS_DIR, dirs[0].name);
+}
+
+function isOrgConnected(targetOrg) {
+  const result = spawnSync('sf', ['org', 'display', '--target-org', targetOrg, '--json'], {
+    cwd: ROOT,
+    stdio: 'pipe',
+    shell: true,
+  });
+  return result.status === 0;
+}
+
+function run(name, cmd, args, opts = {}) {
+  const { cwd = ROOT, optional = false } = opts;
+  console.log('\n---', name, '---');
+  const result = spawnSync(cmd, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: true,
+    ...(opts.timeout && { timeout: opts.timeout }),
+  });
+  if (result.status !== 0 && !optional) {
+    console.error(`\nSetup failed at step: ${name}`);
+    process.exit(result.status ?? 1);
+  }
+  return result;
+}
+
+function main() {
+  const {
+    targetOrg,
+    webappName,
+    permsetName,
+    skipLogin,
+    skipDeploy,
+    skipPermset,
+    skipData,
+    skipGraphql,
+    skipWebappBuild,
+    skipDev,
+  } = parseArgs();
+
+  const webappDir = discoverWebappDir(webappName);
+  const hasDataPlan = existsSync(DATA_PLAN) && existsSync(DATA_DIR);
+  const doData = !skipData && hasDataPlan;
+
+  console.log('Setup — target org:', targetOrg, '| web app:', webappDir);
+  console.log(
+    'Steps: login=%s deploy=%s permset=%s data=%s graphql=%s webapp=%s dev=%s',
+    !skipLogin,
+    !skipDeploy,
+    !skipPermset,
+    doData,
+    !skipGraphql,
+    !skipWebappBuild,
+    !skipDev
+  );
+  if (skipData && hasDataPlan) {
+    console.log('(Data dir present; use without --skip-data to run data import.)');
+  } else if (!hasDataPlan && !skipData) {
+    console.log('(No data plan found; skipping data step.)');
+  }
+
+  if (!skipLogin) {
+    if (isOrgConnected(targetOrg)) {
+      console.log('\n--- Login ---');
+      console.log(`Org ${targetOrg} is already authenticated; skipping browser login.`);
+    } else {
+      run('Login (browser)', 'sf', ['org', 'login', 'web', '--alias', targetOrg], { optional: true });
+    }
+  }
+
+  if (!skipDeploy) {
+    run('Deploy metadata', 'sf', ['project', 'deploy', 'start', '--target-org', targetOrg], {
+      timeout: 180000,
+    });
+  }
+
+  if (!skipPermset && permsetName) {
+    console.log('\n--- Assign permission set ---');
+    const permsetResult = spawnSync(
+      'sf',
+      ['org', 'assign', 'permset', '--name', permsetName, '--target-org', targetOrg],
+      {
+        cwd: ROOT,
+        stdio: 'pipe',
+        shell: true,
+      }
+    );
+    if (permsetResult.status === 0) {
+      console.log('Permission set assigned.');
+    } else {
+      const out =
+        (permsetResult.stderr?.toString() || '') + (permsetResult.stdout?.toString() || '');
+      if (out.includes('Duplicate') && out.includes('PermissionSet')) {
+        console.log('Permission set already assigned; skipping.');
+      } else if (out.includes('not found') && out.includes('target org')) {
+        console.log(`Permission set "${permsetName}" not in org; skipping.`);
+      } else {
+        process.stdout.write(permsetResult.stdout?.toString() || '');
+        process.stderr.write(permsetResult.stderr?.toString() || '');
+        console.error('\nSetup failed at step: Assign permission set');
+        process.exit(permsetResult.status ?? 1);
+      }
+    }
+  }
+
+  if (doData) {
+    // Prepare data for uniqueness (run before import so repeat imports don't conflict)
+    const prepareScript = resolve(__dirname, 'prepare-import-unique-fields.js');
+    run('Prepare data (unique fields)', 'node', [prepareScript, '--data-dir', DATA_DIR], {
+      cwd: ROOT,
+    });
+    // Data import tree: if only DUPLICATES_DETECTED (org duplicate rules), warn and continue
+    console.log('\n--- Data import tree ---');
+    const importResult = spawnSync(
+      'sf',
+      ['data', 'import', 'tree', '--plan', DATA_PLAN, '--target-org', targetOrg, '--json'],
+      { cwd: ROOT, stdio: 'pipe', shell: true, timeout: 120000 }
+    );
+    const out = (importResult.stdout?.toString() || '') + (importResult.stderr?.toString() || '');
+    if (importResult.status !== 0) {
+      let onlyDuplicates = false;
+      try {
+        const j = JSON.parse(out);
+        const errors = Array.isArray(j?.data) ? j.data : [];
+        onlyDuplicates =
+          errors.length > 0 &&
+          errors.every((e) => e.StatusCode === 'DUPLICATES_DETECTED' || e.statusCode === 'DUPLICATES_DETECTED');
+      } catch (_) {
+        onlyDuplicates = out.includes('DUPLICATES_DETECTED') && /Use one of these records\?/.test(out);
+      }
+      if (onlyDuplicates) {
+        console.warn(
+          'Data import hit org duplicate rules (e.g. Contact). Skipping import; rest of setup continues.'
+        );
+      } else {
+        process.stdout.write(importResult.stdout?.toString() || '');
+        process.stderr.write(importResult.stderr?.toString() || '');
+        console.error('\nSetup failed at step: Data import tree');
+        process.exit(importResult.status ?? 1);
+      }
+    }
+  }
+
+  if (!skipGraphql || !skipWebappBuild) {
+    run('Web app npm install', 'npm', ['install'], { cwd: webappDir });
+  }
+
+  if (!skipGraphql) {
+    run('Set default org for schema', 'sf', ['config', 'set', 'target-org', targetOrg, '--global']);
+    run('GraphQL schema (introspect)', 'npm', ['run', 'graphql:schema'], { cwd: webappDir });
+    run('GraphQL codegen', 'npm', ['run', 'graphql:codegen'], { cwd: webappDir });
+  }
+
+  if (!skipWebappBuild) {
+    run('Web app build', 'npm', ['run', 'build'], { cwd: webappDir });
+  }
+
+  console.log('\n--- Setup complete ---');
+
+  if (!skipDev) {
+    console.log('\n--- Launching dev server (Ctrl+C to stop) ---\n');
+    run('Dev server', 'npm', ['run', 'dev'], { cwd: webappDir });
+  }
+}
+
+main();

package/lib/templates/webapplication/reactbasic/package.json

@@ -15,19 +15,19 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/sdk-data": "^1.71.2",
-    "@salesforce/webapp-experimental": "^1.71.2",
+    "@salesforce/sdk-data": "^1.84.0",
+    "@salesforce/webapp-experimental": "^1.84.0",
     "@tailwindcss/vite": "^4.1.17",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-router": "^7.10.1",
-    "tailwindcss": "^4.1.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.562.0",
     "radix-ui": "^1.4.3",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router": "^7.10.1",
     "shadcn": "^3.8.5",
-    "tailwind-merge": "^3.4.0",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.1.17",
     "tw-animate-css": "^1.4.0"
   },
   "devDependencies": {
@@ -38,7 +38,7 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/vite-plugin-webapp-experimental": "^1.71.2",
+    "@salesforce/vite-plugin-webapp-experimental": "^1.84.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/lib/templates/webapplication/reactbasic/webapplication.json

@@ -2,6 +2,6 @@
   "outputDir": "dist",
   "routing": {
     "trailingSlash": "never",
-    "fallback": "/index.html"
+    "fallback": "index.html"
   }
 }

package/lib/templates/webapplication/webappbasic/webapplication.json

@@ -2,6 +2,6 @@
   "outputDir": "src",
   "routing": {
     "trailingSlash": "never",
-    "fallback": "/index.html"
+    "fallback": "index.html"
   }
 }

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/index.ts","../src/generators/analyticsTemplateGenerator.ts","../src/generators/apexClassGenerator.ts","../src/generators/apexTriggerGenerator.ts","../src/generators/baseGenerator.ts","../src/generators/digitalExperienceSiteGenerator.ts","../src/generators/flexipageGenerator.ts","../src/generators/lightningAppGenerator.ts","../src/generators/lightningComponentGenerator.ts","../src/generators/lightningEventGenerator.ts","../src/generators/lightningInterfaceGenerator.ts","../src/generators/lightningTestGenerator.ts","../src/generators/projectGenerator.ts","../src/generators/staticResourceGenerator.ts","../src/generators/visualforceComponentGenerator.ts","../src/generators/visualforcePageGenerator.ts","../src/generators/webApplicationGenerator.ts","../src/i18n/i18n.ts","../src/i18n/index.ts","../src/i18n/localization.ts","../src/service/gitRepoUtils.ts","../src/service/templateService.ts","../src/utils/constants.ts","../src/utils/createUtil.ts","../src/utils/index.ts","../src/utils/types.ts","../src/utils/webappTemplateUtils.ts"],"version":"5.9.3"}
+{"root":["../src/index.ts","../src/generators/analyticsTemplateGenerator.ts","../src/generators/apexClassGenerator.ts","../src/generators/apexTriggerGenerator.ts","../src/generators/baseGenerator.ts","../src/generators/digitalExperienceSiteGenerator.ts","../src/generators/flexipageGenerator.ts","../src/generators/lightningAppGenerator.ts","../src/generators/lightningComponentGenerator.ts","../src/generators/lightningEventGenerator.ts","../src/generators/lightningInterfaceGenerator.ts","../src/generators/lightningTestGenerator.ts","../src/generators/projectGenerator.ts","../src/generators/staticResourceGenerator.ts","../src/generators/visualforceComponentGenerator.ts","../src/generators/visualforcePageGenerator.ts","../src/generators/webApplicationGenerator.ts","../src/i18n/i18n.ts","../src/i18n/index.ts","../src/i18n/localization.ts","../src/service/gitRepoUtils.ts","../src/service/templateService.ts","../src/utils/constants.ts","../src/utils/createUtil.ts","../src/utils/index.ts","../src/utils/template-placeholders.ts","../src/utils/types.ts","../src/utils/webappTemplateUtils.ts"],"version":"5.9.3"}

package/lib/utils/template-placeholders.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Single source for placeholder rename (copy-templates) and replacement (webappTemplateUtils).
+ * Do not add .json - this .ts is compiled to lib/ so no copy step is needed.
+ */
+declare const _default: ({
+    key: string;
+    placeholder: string;
+    dirInNpm: string;
+    parent: string;
+    replacement: string;
+    removeEmptySibling?: undefined;
+    toPath?: undefined;
+    subpath?: undefined;
+} | {
+    key: string;
+    placeholder: string;
+    dirInNpm: string;
+    parent: string;
+    removeEmptySibling: string;
+    replacement: string;
+    toPath?: undefined;
+    subpath?: undefined;
+} | {
+    key: string;
+    placeholder: string;
+    dirInNpm: string;
+    parent: string;
+    toPath: string;
+    replacement: string;
+    removeEmptySibling?: undefined;
+    subpath?: undefined;
+} | {
+    key: string;
+    placeholder: string;
+    dirInNpm: string;
+    parent: string;
+    subpath: string;
+    replacement: string;
+    removeEmptySibling?: undefined;
+    toPath?: undefined;
+})[];
+export default _default;

package/lib/utils/template-placeholders.js

@@ -0,0 +1,103 @@
+"use strict";
+/*
+ * Copyright (c) 2019, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Single source for placeholder rename (copy-templates) and replacement (webappTemplateUtils).
+ * Do not add .json - this .ts is compiled to lib/ so no copy step is needed.
+ */
+exports.default = [
+    {
+        key: 'PACKAGE_DIR_PLACEHOLDER',
+        placeholder: '_p_',
+        dirInNpm: 'force-app',
+        parent: 'dest',
+        replacement: 'defaultpackagedir',
+    },
+    {
+        key: 'MAIN_DEFAULT_PLACEHOLDER',
+        placeholder: '_m_',
+        dirInNpm: 'main/default',
+        parent: '_p_',
+        removeEmptySibling: 'main',
+        replacement: 'main/default',
+    },
+    {
+        key: 'WEBAPPLICATIONS_PLACEHOLDER',
+        placeholder: '_w_',
+        dirInNpm: 'webapplications',
+        parent: '_m_',
+        replacement: 'webapplications',
+    },
+    {
+        key: 'DIGITAL_EXPERIENCES_PLACEHOLDER',
+        placeholder: '_d_',
+        dirInNpm: 'digitalExperiences',
+        parent: '_m_',
+        replacement: 'digitalExperiences',
+    },
+    {
+        key: 'SITE_PLACEHOLDER',
+        placeholder: '_s_',
+        dirInNpm: 'site',
+        parent: '_d_',
+        replacement: 'site',
+    },
+    {
+        key: 'A4DRULES_PLACEHOLDER',
+        placeholder: '_r_',
+        dirInNpm: '.a4drules',
+        parent: 'dest',
+        replacement: '.a4drules',
+    },
+    {
+        key: 'A4D_SKILL_AGENTFORCE_PLACEHOLDER',
+        placeholder: '_k_',
+        dirInNpm: 'skills/feature-react-agentforce-conversation-client-embedded-agent',
+        parent: '_r_',
+        toPath: 'skills/_k_',
+        replacement: 'feature-react-agentforce-conversation-client-embedded-agent',
+    },
+    // Path shortening under app folder (reactb2e/reactb2x) for Windows path length.
+    {
+        key: 'FEATURES_PLACEHOLDER',
+        placeholder: '_f_',
+        dirInNpm: 'features',
+        parent: '_a_',
+        subpath: 'src',
+        replacement: 'features',
+    },
+    {
+        key: 'GLOBAL_SEARCH_PLACEHOLDER',
+        placeholder: '_gs_',
+        dirInNpm: 'global-search',
+        parent: '_f_',
+        replacement: 'global-search',
+    },
+    {
+        key: 'COMPONENTS_PLACEHOLDER',
+        placeholder: '_c_',
+        dirInNpm: 'components',
+        parent: '_gs_',
+        replacement: 'components',
+    },
+    {
+        key: 'DETAIL_PLACEHOLDER',
+        placeholder: '_det_',
+        dirInNpm: 'detail',
+        parent: '_c_',
+        replacement: 'detail',
+    },
+    {
+        key: 'FORMATTED_PLACEHOLDER',
+        placeholder: '_fmt_',
+        dirInNpm: 'formatted',
+        parent: '_det_',
+        replacement: 'formatted',
+    },
+];
+//# sourceMappingURL=template-placeholders.js.map

package/lib/utils/template-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-placeholders.js","sourceRoot":"","sources":["../../src/utils/template-placeholders.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH;;;GAGG;AACH,kBAAe;IACb;QACE,GAAG,EAAE,yBAAyB;QAC9B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,mBAAmB;KACjC;IACD;QACE,GAAG,EAAE,0BAA0B;QAC/B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,KAAK;QACb,kBAAkB,EAAE,MAAM;QAC1B,WAAW,EAAE,cAAc;KAC5B;IACD;QACE,GAAG,EAAE,6BAA6B;QAClC,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,iBAAiB;KAC/B;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,oBAAoB;QAC9B,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,MAAM;KACpB;IACD;QACE,GAAG,EAAE,sBAAsB;QAC3B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,WAAW;KACzB;IACD;QACE,GAAG,EAAE,kCAAkC;QACvC,WAAW,EAAE,KAAK;QAClB,QAAQ,EACN,oEAAoE;QACtE,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,6DAA6D;KAC3E;IACD,gFAAgF;IAChF;QACE,GAAG,EAAE,sBAAsB;QAC3B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,UAAU;KACxB;IACD;QACE,GAAG,EAAE,2BAA2B;QAChC,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,eAAe;QACzB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,GAAG,EAAE,wBAAwB;QAC7B,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,WAAW,EAAE,OAAO;QACpB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,QAAQ;KACtB;IACD;QACE,GAAG,EAAE,uBAAuB;QAC5B,WAAW,EAAE,OAAO;QACpB,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,WAAW;KACzB;CACF,CAAC"}

package/lib/utils/webappTemplateUtils.d.ts

@@ -22,6 +22,48 @@ export declare const FULL_TEMPLATE_DEFAULT_NAMES: Record<string, {
 }>;
 /** Directories to skip when walking a full template dir (e.g. node_modules) */
 export declare const FULL_TEMPLATE_SKIP_DIRS: Set<string>;
+/**
+ * Max path length for package paths allowed by `sf pack:verify` on Windows.
+ * Matches the "supported allowable path length" from ensureWindowsPathLengths in
+ * salesforcecli/cli (plugin-release-management): 259 - supportedBaseWindowsPath.length
+ * with --windows-username-buffer 34 (e.g. supported username length 34 → base path 102 → 157).
+ * Paths with length >= this value fail pack:verify.
+ */
+export declare const WINDOWS_MAX_ALLOWABLE_PATH_LENGTH = 157;
+/**
+ * Path segment placeholders used in template dirs; replaced only during project generation.
+ * Short names keep lib/templates paths short.
+ */
+export declare const PACKAGE_DIR_PLACEHOLDER = "_p_";
+/** Replaced with defaultpackagedir (e.g. force-app). */
+export declare const MAIN_DEFAULT_PLACEHOLDER = "_m_";
+/** Replaced with literal "main/default". */
+export declare const WEBAPPLICATIONS_PLACEHOLDER = "_w_";
+/** Replaced with literal "webapplications". */
+export declare const APP_PLACEHOLDER = "_a_";
+/** Replaced with project name (alphanumeric) for the web app folder. */
+export declare const DIGITAL_EXPERIENCES_PLACEHOLDER = "_d_";
+/** Replaced with literal "digitalExperiences". */
+export declare const SITE_PLACEHOLDER = "_s_";
+/** Replaced with literal "site". */
+export declare const APP_SUFFIX_PLACEHOLDER = "_a1_";
+/** Replaced with project name + "1" (e.g. digital experience site folder). */
+export declare const A4DRULES_PLACEHOLDER = "_r_";
+/** Replaced with literal ".a4drules". */
+export declare const A4D_SKILL_AGENTFORCE_PLACEHOLDER = "_k_";
+/** Replaced with literal "feature-react-agentforce-conversation-client-embedded-agent". */
+/** Replaced with literal "features" (under app src; short for Windows path length). */
+export declare const FEATURES_PLACEHOLDER = "_f_";
+/** Replaced with literal "global-search". */
+export declare const GLOBAL_SEARCH_PLACEHOLDER = "_gs_";
+/** Replaced with literal "components". */
+export declare const COMPONENTS_PLACEHOLDER = "_c_";
+/** Replaced with literal "detail". */
+export declare const DETAIL_PLACEHOLDER = "_det_";
+/** Replaced with literal "formatted". */
+export declare const FORMATTED_PLACEHOLDER = "_fmt_";
+/** All placeholder keys; used by tests to assert sync with copy-templates.js */
+export declare const PLACEHOLDER_KEYS: readonly ["PACKAGE_DIR_PLACEHOLDER", "MAIN_DEFAULT_PLACEHOLDER", "WEBAPPLICATIONS_PLACEHOLDER", "APP_PLACEHOLDER", "DIGITAL_EXPERIENCES_PLACEHOLDER", "SITE_PLACEHOLDER", "APP_SUFFIX_PLACEHOLDER", "A4DRULES_PLACEHOLDER", "A4D_SKILL_AGENTFORCE_PLACEHOLDER", "FEATURES_PLACEHOLDER", "GLOBAL_SEARCH_PLACEHOLDER", "COMPONENTS_PLACEHOLDER", "DETAIL_PLACEHOLDER", "FORMATTED_PLACEHOLDER"];
 /**
  * Returns a string containing only alphanumeric characters [A-Za-z0-9].
  * Used for folder and file names under webapplications, which must be alphanumeric.

package/lib/utils/webappTemplateUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FULL_TEMPLATE_SKIP_DIRS = exports.FULL_TEMPLATE_DEFAULT_NAMES = exports.BUILT_IN_FULL_TEMPLATES = exports.EJS_EXTENSIONS = void 0;
+exports.PLACEHOLDER_KEYS = exports.FORMATTED_PLACEHOLDER = exports.DETAIL_PLACEHOLDER = exports.COMPONENTS_PLACEHOLDER = exports.GLOBAL_SEARCH_PLACEHOLDER = exports.FEATURES_PLACEHOLDER = exports.A4D_SKILL_AGENTFORCE_PLACEHOLDER = exports.A4DRULES_PLACEHOLDER = exports.APP_SUFFIX_PLACEHOLDER = exports.SITE_PLACEHOLDER = exports.DIGITAL_EXPERIENCES_PLACEHOLDER = exports.APP_PLACEHOLDER = exports.WEBAPPLICATIONS_PLACEHOLDER = exports.MAIN_DEFAULT_PLACEHOLDER = exports.PACKAGE_DIR_PLACEHOLDER = exports.WINDOWS_MAX_ALLOWABLE_PATH_LENGTH = exports.FULL_TEMPLATE_SKIP_DIRS = exports.FULL_TEMPLATE_DEFAULT_NAMES = exports.BUILT_IN_FULL_TEMPLATES = exports.EJS_EXTENSIONS = void 0;
 exports.copyTreeSanitized = copyTreeSanitized;
 exports.toAlphanumericForPath = toAlphanumericForPath;
 exports.isLikelyText = isLikelyText;
@@ -17,6 +17,7 @@ const tslib_1 = require("tslib");
 const fs = require("fs");
 const promises_1 = require("node:fs/promises");
 const path = require("path");
+const template_placeholders_1 = require("./template-placeholders");
 /**
  * Trim trailing whitespace from a filename segment and warn when it differs.
  * Upstream packages occasionally ship files whose names end with a space
@@ -98,6 +99,76 @@ exports.FULL_TEMPLATE_DEFAULT_NAMES = {
 };
 /** Directories to skip when walking a full template dir (e.g. node_modules) */
 exports.FULL_TEMPLATE_SKIP_DIRS = new Set(['node_modules', '.git']);
+/**
+ * Max path length for package paths allowed by `sf pack:verify` on Windows.
+ * Matches the "supported allowable path length" from ensureWindowsPathLengths in
+ * salesforcecli/cli (plugin-release-management): 259 - supportedBaseWindowsPath.length
+ * with --windows-username-buffer 34 (e.g. supported username length 34 → base path 102 → 157).
+ * Paths with length >= this value fail pack:verify.
+ */
+exports.WINDOWS_MAX_ALLOWABLE_PATH_LENGTH = 157;
+/**
+ * Path segment placeholders used in template dirs; replaced only during project generation.
+ * Short names keep lib/templates paths short.
+ */
+exports.PACKAGE_DIR_PLACEHOLDER = '_p_';
+/** Replaced with defaultpackagedir (e.g. force-app). */
+exports.MAIN_DEFAULT_PLACEHOLDER = '_m_';
+/** Replaced with literal "main/default". */
+exports.WEBAPPLICATIONS_PLACEHOLDER = '_w_';
+/** Replaced with literal "webapplications". */
+exports.APP_PLACEHOLDER = '_a_';
+/** Replaced with project name (alphanumeric) for the web app folder. */
+exports.DIGITAL_EXPERIENCES_PLACEHOLDER = '_d_';
+/** Replaced with literal "digitalExperiences". */
+exports.SITE_PLACEHOLDER = '_s_';
+/** Replaced with literal "site". */
+exports.APP_SUFFIX_PLACEHOLDER = '_a1_';
+/** Replaced with project name + "1" (e.g. digital experience site folder). */
+exports.A4DRULES_PLACEHOLDER = '_r_';
+/** Replaced with literal ".a4drules". */
+exports.A4D_SKILL_AGENTFORCE_PLACEHOLDER = '_k_';
+/** Replaced with literal "feature-react-agentforce-conversation-client-embedded-agent". */
+/** Replaced with literal "features" (under app src; short for Windows path length). */
+exports.FEATURES_PLACEHOLDER = '_f_';
+/** Replaced with literal "global-search". */
+exports.GLOBAL_SEARCH_PLACEHOLDER = '_gs_';
+/** Replaced with literal "components". */
+exports.COMPONENTS_PLACEHOLDER = '_c_';
+/** Replaced with literal "detail". */
+exports.DETAIL_PLACEHOLDER = '_det_';
+/** Replaced with literal "formatted". */
+exports.FORMATTED_PLACEHOLDER = '_fmt_';
+/** All placeholder keys; used by tests to assert sync with copy-templates.js */
+exports.PLACEHOLDER_KEYS = [
+    'PACKAGE_DIR_PLACEHOLDER',
+    'MAIN_DEFAULT_PLACEHOLDER',
+    'WEBAPPLICATIONS_PLACEHOLDER',
+    'APP_PLACEHOLDER',
+    'DIGITAL_EXPERIENCES_PLACEHOLDER',
+    'SITE_PLACEHOLDER',
+    'APP_SUFFIX_PLACEHOLDER',
+    'A4DRULES_PLACEHOLDER',
+    'A4D_SKILL_AGENTFORCE_PLACEHOLDER',
+    'FEATURES_PLACEHOLDER',
+    'GLOBAL_SEARCH_PLACEHOLDER',
+    'COMPONENTS_PLACEHOLDER',
+    'DETAIL_PLACEHOLDER',
+    'FORMATTED_PLACEHOLDER',
+];
+const TEMPLATE_PLACEHOLDERS_SPEC = template_placeholders_1.default;
+function resolveReplacement(replacement, ctx) {
+    switch (replacement) {
+        case 'defaultpackagedir':
+            return ctx.defaultpackagedir;
+        case 'projectname':
+            return ctx.projectnameAlphanumeric;
+        case 'projectname1':
+            return ctx.projectnameAlphanumeric + '1';
+        default:
+            return replacement;
+    }
+}
 /**
  * Returns a string containing only alphanumeric characters [A-Za-z0-9].
  * Used for folder and file names under webapplications, which must be alphanumeric.
@@ -172,12 +243,18 @@ function generateBuiltInFullTemplate(template, projectname, options) {
         };
         const nameReplacementsEntry = exports.FULL_TEMPLATE_DEFAULT_NAMES[template];
         const projectnameAlphanumeric = toAlphanumericForPath(projectname);
-        const nameReplacements = nameReplacementsEntry
-            ? [
-                [nameReplacementsEntry.withSuffix, projectnameAlphanumeric + '1'],
-                [nameReplacementsEntry.base, projectnameAlphanumeric],
-            ]
-            : undefined;
+        const replacementCtx = {
+            defaultpackagedir,
+            projectnameAlphanumeric,
+        };
+        const nameReplacements = TEMPLATE_PLACEHOLDERS_SPEC.map((entry) => [
+            entry.placeholder,
+            resolveReplacement(entry.replacement, replacementCtx),
+        ]);
+        nameReplacements.push([exports.APP_PLACEHOLDER, projectnameAlphanumeric], [exports.APP_SUFFIX_PLACEHOLDER, projectnameAlphanumeric + '1']);
+        if (nameReplacementsEntry) {
+            nameReplacements.push([nameReplacementsEntry.withSuffix, projectnameAlphanumeric + '1'], [nameReplacementsEntry.base, projectnameAlphanumeric]);
+        }
         yield generateFromProjectTemplateDir(templateDir, projectDir, templateVars, {
             nameReplacements,
             renderEjs,