@simplysf/simply-utam-core 0.1.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/README.md +72 -14
  2. package/lib/forceignore/forceignore-manager.d.ts +30 -0
  3. package/lib/forceignore/forceignore-manager.js +30 -13
  4. package/lib/forceignore/forceignore-manager.js.map +1 -1
  5. package/lib/forceignore/index.d.ts +1 -1
  6. package/lib/forceignore/index.js +1 -1
  7. package/lib/forceignore/index.js.map +1 -1
  8. package/lib/gitignore/gitignore-manager.d.ts +64 -0
  9. package/lib/gitignore/gitignore-manager.js +96 -0
  10. package/lib/gitignore/gitignore-manager.js.map +1 -0
  11. package/lib/gitignore/index.d.ts +1 -0
  12. package/lib/gitignore/index.js +17 -0
  13. package/lib/gitignore/index.js.map +1 -0
  14. package/lib/index.d.ts +3 -1
  15. package/lib/index.js +3 -1
  16. package/lib/index.js.map +1 -1
  17. package/lib/namespaces/namespace-map.d.ts +18 -0
  18. package/lib/namespaces/namespace-map.js +75 -0
  19. package/lib/namespaces/namespace-map.js.map +1 -0
  20. package/lib/namespaces/namespace-rewriter.js +2 -47
  21. package/lib/namespaces/namespace-rewriter.js.map +1 -1
  22. package/lib/path-utils.d.ts +8 -0
  23. package/lib/path-utils.js +10 -0
  24. package/lib/path-utils.js.map +1 -1
  25. package/lib/scaffold/project-scaffolder.d.ts +75 -1
  26. package/lib/scaffold/project-scaffolder.js +267 -19
  27. package/lib/scaffold/project-scaffolder.js.map +1 -1
  28. package/lib/snapshot/capture.d.ts +56 -0
  29. package/lib/snapshot/capture.js +115 -0
  30. package/lib/snapshot/capture.js.map +1 -0
  31. package/lib/snapshot/console.d.ts +25 -0
  32. package/lib/snapshot/console.js +74 -0
  33. package/lib/snapshot/console.js.map +1 -0
  34. package/lib/snapshot/describe.d.ts +27 -0
  35. package/lib/snapshot/describe.js +76 -0
  36. package/lib/snapshot/describe.js.map +1 -0
  37. package/lib/snapshot/files.d.ts +85 -0
  38. package/lib/snapshot/files.js +185 -0
  39. package/lib/snapshot/files.js.map +1 -0
  40. package/lib/snapshot/find.d.ts +36 -0
  41. package/lib/snapshot/find.js +186 -0
  42. package/lib/snapshot/find.js.map +1 -0
  43. package/lib/snapshot/format.d.ts +96 -0
  44. package/lib/snapshot/format.js +100 -0
  45. package/lib/snapshot/format.js.map +1 -0
  46. package/lib/snapshot/header.d.ts +38 -0
  47. package/lib/snapshot/header.js +120 -0
  48. package/lib/snapshot/header.js.map +1 -0
  49. package/lib/snapshot/index.d.ts +13 -0
  50. package/lib/snapshot/index.js +28 -0
  51. package/lib/snapshot/index.js.map +1 -0
  52. package/lib/snapshot/locate.d.ts +61 -0
  53. package/lib/snapshot/locate.js +110 -0
  54. package/lib/snapshot/locate.js.map +1 -0
  55. package/lib/snapshot/lookup.d.ts +53 -0
  56. package/lib/snapshot/lookup.js +188 -0
  57. package/lib/snapshot/lookup.js.map +1 -0
  58. package/lib/snapshot/page-object-index.d.ts +149 -0
  59. package/lib/snapshot/page-object-index.js +806 -0
  60. package/lib/snapshot/page-object-index.js.map +1 -0
  61. package/lib/snapshot/page-object-packages.d.ts +41 -0
  62. package/lib/snapshot/page-object-packages.js +115 -0
  63. package/lib/snapshot/page-object-packages.js.map +1 -0
  64. package/lib/snapshot/path.d.ts +102 -0
  65. package/lib/snapshot/path.js +381 -0
  66. package/lib/snapshot/path.js.map +1 -0
  67. package/lib/snapshot/query-result.d.ts +20 -0
  68. package/lib/snapshot/query-result.js +32 -0
  69. package/lib/snapshot/query-result.js.map +1 -0
  70. package/lib/snapshot/selector.d.ts +103 -0
  71. package/lib/snapshot/selector.js +280 -0
  72. package/lib/snapshot/selector.js.map +1 -0
  73. package/lib/snapshot/tree.d.ts +76 -0
  74. package/lib/snapshot/tree.js +201 -0
  75. package/lib/snapshot/tree.js.map +1 -0
  76. package/lib/snapshot/walker.js +532 -0
  77. package/package.json +11 -3
  78. package/templates/dom-snapshot.steps.mjs +34 -0
  79. package/templates/wdio.conf.mjs +81 -4
@@ -17,8 +17,9 @@ import * as fs from 'node:fs';
17
17
  import * as path from 'node:path';
18
18
  import { fileURLToPath } from 'node:url';
19
19
  import { parseSfdxProject } from '../discovery/sfdx-project.js';
20
- import { isAbsoluteOnAnyPlatform, toPosixRelative } from '../path-utils.js';
20
+ import { isAbsoluteOnAnyPlatform, isOutsideProject, toPosixRelative } from '../path-utils.js';
21
21
  import { SIMPLY_UTAM_FORCEIGNORE_RULES, ensureForceignore, resolveUtamTestIgnoreRules, } from '../forceignore/index.js';
22
+ import { ensureGitignore } from '../gitignore/index.js';
22
23
  const currentDir = path.dirname(fileURLToPath(import.meta.url));
23
24
  /**
24
25
  * Default location of external scaffold template files.
@@ -96,17 +97,41 @@ export function generateUtamConfig(templatesDir = DEFAULT_TEMPLATES_DIR) {
96
97
  const raw = loadTemplate('utam.config.json', templatesDir);
97
98
  return JSON.parse(raw);
98
99
  }
100
+ /**
101
+ * Whether the template's globs, which take every `test` folder under the source folder, reach a test
102
+ * folder: it's under the source folder, with a `test` folder on the way.
103
+ */
104
+ function underSourceTestGlobs(sourceDir, testDir) {
105
+ const relative = path.relative(sourceDir, testDir);
106
+ return !relative.startsWith('..') && !path.isAbsolute(relative) && relative.split(path.sep).includes('test');
107
+ }
108
+ /** Adds entries to a one-line `key: [...]` array in the generated config, one per line. */
109
+ function appendToArray(content, key, entries) {
110
+ return content.replace(new RegExp(`^( *)${key}: \\[(.*)\\],$`, 'm'), (_line, indent, items) => {
111
+ const all = [...items.split(/,\s*/), ...entries.map((entry) => `'${entry.replaceAll("'", "\\'")}'`)];
112
+ return `${indent}${key}: [\n${all.map((item) => `${indent} ${item},\n`).join('')}${indent}],`;
113
+ });
114
+ }
99
115
  /**
100
116
  * Generates the wdio.conf.mjs configuration script content by loading its external template.
101
117
  *
102
118
  * @param sourceDir - The primary Salesforce source directory.
103
119
  * @param templatesDir - Optional custom directory containing the template file.
120
+ * @param testDirs - The project's UTAM test folders. Those the template's globs don't reach, such as
121
+ * `test/utam` at the project root or `<sourceDir>/tests/utam`, are added to `specs` and
122
+ * `cucumberOpts.require`.
104
123
  * @returns Formatted JavaScript module text for wdio.conf.mjs.
105
124
  */
106
- export function generateWdioConfig(sourceDir, templatesDir = DEFAULT_TEMPLATES_DIR) {
107
- return loadTemplate('wdio.conf.mjs', templatesDir, {
125
+ export function generateWdioConfig(sourceDir, templatesDir = DEFAULT_TEMPLATES_DIR, testDirs = []) {
126
+ const content = loadTemplate('wdio.conf.mjs', templatesDir, {
108
127
  sourceDir: toPosixRelative(sourceDir) || '.',
109
128
  });
129
+ const extraDirs = testDirs.filter((dir) => !underSourceTestGlobs(sourceDir, dir)).map(toPosixRelative);
130
+ if (extraDirs.length === 0) {
131
+ return content;
132
+ }
133
+ const specs = appendToArray(content, 'specs', extraDirs.map((dir) => `${dir}/**/*.feature`));
134
+ return appendToArray(specs, 'require', extraDirs.map((dir) => `${dir}/**/*.steps.mjs`));
110
135
  }
111
136
  /**
112
137
  * Generates the .utam/namespace-map.json content by loading its external template.
@@ -149,6 +174,16 @@ export function generateHelloSteps(templatesDir = DEFAULT_TEMPLATES_DIR) {
149
174
  return `import { Given } from '@wdio/cucumber-framework';\nimport { goToApplication } from '@simplysf/simply-utam';\n\nGiven('I open the Salesforce application {string}', async (appName) => {\n // Authenticates via Salesforce CLI frontdoor URL and opens the application home page\n await goToApplication(appName);\n});\n`;
150
175
  }
151
176
  }
177
+ /**
178
+ * Generates the dom-snapshot.steps.mjs step definitions (`I capture the DOM snapshot`) by loading
179
+ * their external template.
180
+ *
181
+ * @param templatesDir - Optional custom directory containing the template file.
182
+ * @returns The step definitions' JavaScript module text.
183
+ */
184
+ export function generateSnapshotSteps(templatesDir = DEFAULT_TEMPLATES_DIR) {
185
+ return loadTemplate('dom-snapshot.steps.mjs', templatesDir);
186
+ }
152
187
  /**
153
188
  * Non-destructively injects standard UTAM Wireit scripts and task configurations into a package.json object.
154
189
  * Loads task definitions from external wireit.json template.
@@ -184,6 +219,58 @@ export function injectWireitConfiguration(packageJson, templatesDir = DEFAULT_TE
184
219
  const updated = addedScripts.length > 0 || addedTasks.length > 0;
185
220
  return { updated, packageJson: result, addedScripts, addedTasks };
186
221
  }
222
+ /**
223
+ * Adds the package.json "exports" entry that lets compiled page objects import each other. The UTAM
224
+ * compiler writes those imports as extensionless subpaths of the project's own package name
225
+ * ('my-app/pageObjects/bar'), taken from the generator namespace, which Node resolves only through
226
+ * "exports", so the entry maps them to the .js files in the output folder. Only ever adds the one key:
227
+ * an existing entry is never changed, and an "exports" that can't be extended without restructuring it
228
+ * is left alone.
229
+ *
230
+ * @param packageJson - The existing package.json object.
231
+ * @param outputDir - The page object output folder, pageObjectsOutputDir in utam.config.json.
232
+ * @param importDir - The part of the namespace after the package name, 'pageObjects' for 'my-app/pageObjects/'.
233
+ * @returns The package.json object, updated or as given, and what was done.
234
+ */
235
+ export function ensurePageObjectExports(packageJson, outputDir = 'pageObjects', importDir = 'pageObjects') {
236
+ const skip = (reason, subpath) => ({
237
+ packageJson,
238
+ result: { action: 'skipped', subpath, createdExports: false, reason },
239
+ });
240
+ const dir = toPosixRelative(outputDir);
241
+ if (!dir || isOutsideProject(dir)) {
242
+ return skip(`the page object folder "${outputDir}" is not inside the project, so it can't be exported`);
243
+ }
244
+ const imports = toPosixRelative(importDir);
245
+ if (isOutsideProject(imports)) {
246
+ return skip(`the namespace path "${importDir}" is not a subpath of the package, so it can't be exported`);
247
+ }
248
+ const subpath = imports ? `./${imports}/*` : './*';
249
+ const target = `./${dir}/*.js`;
250
+ const exportsField = packageJson['exports'];
251
+ if (exportsField === undefined) {
252
+ return {
253
+ packageJson: { ...packageJson, exports: { [subpath]: target } },
254
+ result: { action: 'added', subpath, createdExports: true },
255
+ };
256
+ }
257
+ if (exportsField === null || typeof exportsField !== 'object' || Array.isArray(exportsField)) {
258
+ return skip(`"exports" is not an object of subpaths`, subpath);
259
+ }
260
+ const keys = Object.keys(exportsField);
261
+ if (keys.some((key) => !key.startsWith('.'))) {
262
+ return skip(`"exports" is an object of conditions, not subpaths`, subpath);
263
+ }
264
+ // Only the exact key counts: a broader pattern such as "./*": "./*" may map to the extensionless path,
265
+ // and the more specific key added here takes precedence over it.
266
+ if (keys.includes(subpath)) {
267
+ return { packageJson, result: { action: 'unchanged', subpath, createdExports: false } };
268
+ }
269
+ return {
270
+ packageJson: { ...packageJson, exports: { ...exportsField, [subpath]: target } },
271
+ result: { action: 'added', subpath, createdExports: false },
272
+ };
273
+ }
187
274
  /**
188
275
  * Checks a package.json object for missing recommended devDependencies.
189
276
  *
@@ -208,15 +295,130 @@ function resolveSourceDir(sfdxProject, explicitSourceDir) {
208
295
  }
209
296
  return 'force-app';
210
297
  }
298
+ // The full package name, scope included: page objects import each other by this name, and Node only
299
+ // resolves a package's own name when it matches package.json "name" exactly.
211
300
  function resolveAppName(packageJsonData, explicitAppName) {
212
301
  if (explicitAppName) {
213
302
  return explicitAppName;
214
303
  }
215
304
  if (typeof packageJsonData?.['name'] === 'string') {
216
- return packageJsonData['name'].replace(/^@[^/]+\//, '');
305
+ return packageJsonData['name'];
217
306
  }
218
307
  return 'salesforce-app';
219
308
  }
309
+ /**
310
+ * Reads a config file that scaffolding keeps, which is any that exists unless force is set. Undefined
311
+ * when the file is written fresh or can't be parsed as a JSON object.
312
+ */
313
+ function readKeptConfig(projectDir, relativePath, force) {
314
+ const filePath = path.join(projectDir, relativePath);
315
+ if (force || !fs.existsSync(filePath)) {
316
+ return undefined;
317
+ }
318
+ try {
319
+ const config = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
320
+ return config !== null && typeof config === 'object' ? config : undefined;
321
+ }
322
+ catch {
323
+ return undefined;
324
+ }
325
+ }
326
+ /**
327
+ * The namespace page objects are generated under: the one in a generator.config.json that scaffolding
328
+ * keeps, or the one it writes from appName.
329
+ */
330
+ function resolveNamespace(projectDir, force, appName) {
331
+ const namespaces = readKeptConfig(projectDir, 'generator.config.json', force)?.['namespaces'];
332
+ const namespace = namespaces?.['c'];
333
+ return typeof namespace === 'string'
334
+ ? { namespace, kept: true }
335
+ : { namespace: `${appName}/pageObjects/`, kept: false };
336
+ }
337
+ /**
338
+ * The page object output folder: pageObjectsOutputDir from the kept utam.config.json, or from the one
339
+ * init writes when there is none or it can't be read.
340
+ */
341
+ function resolvePageObjectsOutputDir(projectDir, force, utamConfig) {
342
+ const outputDir = (readKeptConfig(projectDir, 'utam.config.json', force) ?? utamConfig)['pageObjectsOutputDir'];
343
+ return typeof outputDir === 'string' ? outputDir : 'pageObjects';
344
+ }
345
+ /**
346
+ * Moves namespace map keys from the namespace scaffolding derives from appName to the one page objects
347
+ * are actually generated under, so a kept generator.config.json and a new map agree.
348
+ */
349
+ function rebaseNamespaceMap(map, from, to) {
350
+ if (from === to) {
351
+ return map;
352
+ }
353
+ return Object.fromEntries(Object.entries(map).map(([key, value]) => [key.startsWith(from) ? to + key.slice(from.length) : key, value]));
354
+ }
355
+ /**
356
+ * Explains why imports under a namespace outside the package name can't resolve. A kept
357
+ * generator.config.json with the namespace older versions derived from a scoped package name, which
358
+ * dropped the scope ("my-app" for "@acme/my-app"), gets the commands that fix or keep it.
359
+ */
360
+ function namespaceMismatchWarning(namespace, kept, packageName, appName) {
361
+ if (typeof packageName === 'string') {
362
+ const stripped = packageName.replace(/^@[^/]+\//, '');
363
+ if (kept && stripped !== packageName && stripped !== appName && namespace === `${stripped}/pageObjects/`) {
364
+ return (`generator.config.json uses the namespace "${stripped}", which drops the scope from "${packageName}", ` +
365
+ `so page object imports cannot resolve by the package's own name. Re-run with --force to use ` +
366
+ `"${appName}", or keep the old namespace with --app-name ${stripped}.`);
367
+ }
368
+ }
369
+ // The package part of the namespace: two segments when scoped, one otherwise.
370
+ const alias = namespace
371
+ .split('/')
372
+ .slice(0, namespace.startsWith('@') ? 2 : 1)
373
+ .join('/');
374
+ const where = kept ? ' in generator.config.json' : '';
375
+ if (alias === packageName) {
376
+ return (`The namespace "${namespace}"${where} has no path after the package name, so page object imports ` +
377
+ `cannot map to files through "exports". Use "${alias}/pageObjects/".`);
378
+ }
379
+ const named = typeof packageName === 'string' ? `the package name "${packageName}"` : 'no package name';
380
+ return (`The namespace "${alias}"${where} differs from ${named}, so page object imports cannot resolve through ` +
381
+ `"exports". Use the package name, or alias the namespace with a dependency ("${alias}": "file:." ` +
382
+ `with npm, "link:." with pnpm) and a loader that resolves extensionless paths.`);
383
+ }
384
+ /**
385
+ * Plans the page object "exports" entry. Skipped when the namespace is not under the package name,
386
+ * because a package resolves only its own name through "exports".
387
+ */
388
+ function planPageObjectExports(packageJson, generated, appName, outputDir) {
389
+ const { namespace, kept } = generated;
390
+ const packageName = packageJson['name'];
391
+ if (typeof packageName !== 'string' || !namespace.startsWith(`${packageName}/`)) {
392
+ return {
393
+ packageJson,
394
+ result: { action: 'skipped', createdExports: false, reason: 'the namespace is not under the package name' },
395
+ warning: namespaceMismatchWarning(namespace, kept, packageName, appName),
396
+ };
397
+ }
398
+ const planned = ensurePageObjectExports(packageJson, outputDir, namespace.slice(packageName.length + 1));
399
+ if (planned.result.action !== 'skipped') {
400
+ return planned;
401
+ }
402
+ const { subpath, reason } = planned.result;
403
+ const advice = subpath
404
+ ? ` Add "${subpath}" to it yourself, mapped to the .js files, so page objects can import each other.`
405
+ : '';
406
+ return { ...planned, warning: `Did not change package.json "exports": ${reason}.${advice}` };
407
+ }
408
+ /**
409
+ * Plans the package.json changes: the Wireit tasks and the page object "exports" entry. packageJson is
410
+ * absent when neither changes anything.
411
+ */
412
+ function updatePackageJson(packageJsonData, templatesDir, generated, appName, outputDir) {
413
+ const injection = injectWireitConfiguration(packageJsonData, templatesDir);
414
+ const planned = planPageObjectExports(injection.packageJson, generated, appName, outputDir);
415
+ const changed = injection.updated || planned.result.action === 'added';
416
+ return {
417
+ packageJson: changed ? planned.packageJson : undefined,
418
+ pageObjectExports: planned.result,
419
+ warning: planned.warning,
420
+ };
421
+ }
220
422
  function writeScaffoldFiles(projectDir, filesToCreate, force, dryRun) {
221
423
  const createdFiles = [];
222
424
  const skippedFiles = [];
@@ -266,12 +468,36 @@ function planUtamTests(projectDir, sourceDir, templatesDir, force) {
266
468
  testDirs: [...existingUtamDirs, scaffoldDir],
267
469
  };
268
470
  }
269
- function recordForceignore(forceignore, createdFiles, modifiedFiles) {
270
- if (forceignore?.action === 'created') {
271
- createdFiles.push(forceignore.path);
471
+ /**
472
+ * The DOM snapshot capture step, in the UTAM test folder. It's a new file, so an existing project
473
+ * gets it too.
474
+ */
475
+ function planSnapshotFiles(testDir, templatesDir) {
476
+ return [
477
+ {
478
+ relativePath: path.join(testDir, 'step_definitions', 'dom-snapshot.steps.mjs'),
479
+ content: generateSnapshotSteps(templatesDir),
480
+ },
481
+ ];
482
+ }
483
+ /** Whether a wdio.conf.mjs that scaffolding kept captures DOM snapshots on failure. */
484
+ function lacksSnapshotHooks(projectDir, skippedFiles) {
485
+ if (!skippedFiles.includes('wdio.conf.mjs')) {
486
+ return false;
272
487
  }
273
- else if (forceignore?.action === 'appended' || forceignore?.action === 'inserted') {
274
- modifiedFiles.push(forceignore.path);
488
+ try {
489
+ return !fs.readFileSync(path.join(projectDir, 'wdio.conf.mjs'), 'utf-8').includes('captureDomSnapshot');
490
+ }
491
+ catch {
492
+ return false;
493
+ }
494
+ }
495
+ function recordIgnoreFile(ignoreFile, createdFiles, modifiedFiles) {
496
+ if (ignoreFile?.action === 'created') {
497
+ createdFiles.push(ignoreFile.path);
498
+ }
499
+ else if (ignoreFile?.action === 'appended' || ignoreFile?.action === 'inserted') {
500
+ modifiedFiles.push(ignoreFile.path);
275
501
  }
276
502
  }
277
503
  function updateForceignore(projectDir, sourceDir, testDirs, sfdxProject, options) {
@@ -287,6 +513,12 @@ function updateForceignore(projectDir, sourceDir, testDirs, sfdxProject, options
287
513
  dryRun: options?.dryRun,
288
514
  });
289
515
  }
516
+ function updateGitignore(projectDir, options) {
517
+ if (options?.gitignore === false) {
518
+ return undefined;
519
+ }
520
+ return ensureGitignore({ projectDir, dryRun: options?.dryRun });
521
+ }
290
522
  /**
291
523
  * Scaffolds standard UTAM configurations, Wireit tasks, and namespace maps in a project directory, and adds
292
524
  * the .forceignore rules that keep UTAM artifacts out of Salesforce deploys.
@@ -315,6 +547,10 @@ export function scaffoldProject(options) {
315
547
  }
316
548
  }
317
549
  const appName = resolveAppName(packageJsonData, options?.appName);
550
+ const utamConfig = generateUtamConfig(templatesDir);
551
+ const generated = resolveNamespace(projectDir, force, appName);
552
+ const namespaceMap = rebaseNamespaceMap(generateNamespaceMap(appName, templatesDir), `${appName}/pageObjects/`, generated.namespace);
553
+ const utamTests = planUtamTests(projectDir, sourceDir, templatesDir, force);
318
554
  const filesToCreate = [
319
555
  {
320
556
  relativePath: 'generator.config.json',
@@ -322,31 +558,39 @@ export function scaffoldProject(options) {
322
558
  },
323
559
  {
324
560
  relativePath: 'utam.config.json',
325
- content: JSON.stringify(generateUtamConfig(templatesDir), null, 2) + '\n',
561
+ content: JSON.stringify(utamConfig, null, 2) + '\n',
326
562
  },
327
563
  {
328
564
  relativePath: 'wdio.conf.mjs',
329
- content: generateWdioConfig(sourceDir, templatesDir),
565
+ // Its globs cover every UTAM test folder, so they reach the snapshot step wherever it goes.
566
+ content: generateWdioConfig(sourceDir, templatesDir, utamTests.testDirs),
330
567
  },
331
568
  {
332
569
  relativePath: path.join('.utam', 'namespace-map.json'),
333
- content: JSON.stringify(generateNamespaceMap(appName, templatesDir), null, 2) + '\n',
570
+ content: JSON.stringify(namespaceMap, null, 2) + '\n',
334
571
  },
335
572
  ];
336
- const utamTests = planUtamTests(projectDir, sourceDir, templatesDir, force);
337
- filesToCreate.push(...utamTests.files);
573
+ filesToCreate.push(...utamTests.files, ...planSnapshotFiles(utamTests.testDirs[0], templatesDir));
338
574
  const { createdFiles, skippedFiles } = writeScaffoldFiles(projectDir, filesToCreate, force, dryRun);
339
575
  const modifiedFiles = [];
576
+ const warnings = [];
340
577
  let updatedPackageJson;
341
578
  const forceignore = updateForceignore(projectDir, sourceDir, utamTests.testDirs, sfdxProject, options);
342
- recordForceignore(forceignore, createdFiles, modifiedFiles);
579
+ recordIgnoreFile(forceignore, createdFiles, modifiedFiles);
580
+ const gitignore = updateGitignore(projectDir, options);
581
+ recordIgnoreFile(gitignore, createdFiles, modifiedFiles);
582
+ let pageObjectExports;
343
583
  if (packageJsonData) {
344
- const injection = injectWireitConfiguration(packageJsonData, templatesDir);
345
- if (injection.updated) {
584
+ const update = updatePackageJson(packageJsonData, templatesDir, generated, appName, resolvePageObjectsOutputDir(projectDir, force, utamConfig));
585
+ pageObjectExports = update.pageObjectExports;
586
+ if (update.warning) {
587
+ warnings.push(update.warning);
588
+ }
589
+ if (update.packageJson) {
346
590
  modifiedFiles.push('package.json');
347
- updatedPackageJson = injection.packageJson;
591
+ updatedPackageJson = update.packageJson;
348
592
  if (!dryRun) {
349
- fs.writeFileSync(packageJsonPath, JSON.stringify(injection.packageJson, null, 2) + '\n', 'utf-8');
593
+ fs.writeFileSync(packageJsonPath, JSON.stringify(updatedPackageJson, null, 2) + '\n', 'utf-8');
350
594
  }
351
595
  }
352
596
  }
@@ -360,6 +604,10 @@ export function scaffoldProject(options) {
360
604
  updatedPackageJson,
361
605
  missingDependencies,
362
606
  forceignore,
607
+ gitignore,
608
+ snapshotHooksMissing: lacksSnapshotHooks(projectDir, skippedFiles),
609
+ pageObjectExports,
610
+ warnings,
363
611
  });
364
612
  }
365
613
  //# sourceMappingURL=project-scaffolder.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"project-scaffolder.js","sourceRoot":"","sources":["../../src/scaffold/project-scaffolder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"project-scaffolder.js","sourceRoot":"","sources":["../../src/scaffold/project-scaffolder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ import type { EnvLike } from '../test-environment.js';
2
+ import { type DomSnapshot, type SnapshotMask, type SnapshotTrigger } from './format.js';
3
+ /** Runs the walker's source in a page and returns the JSON text it produces. */
4
+ export type SnapshotPage = {
5
+ evaluate(source: string, timeoutMs: number): Promise<string>;
6
+ };
7
+ /** The part of a WebdriverIO browser capture uses. */
8
+ export type SnapshotBrowser = {
9
+ execute(script: string, ...args: unknown[]): Promise<unknown>;
10
+ };
11
+ export type CaptureDomSnapshotOptions = WalkerOptions & {
12
+ /** The browser to capture. Defaults to WebdriverIO's global `browser`. */
13
+ browser?: SnapshotBrowser;
14
+ /** Any other way to run the walker; used instead of `browser` when given. */
15
+ page?: SnapshotPage;
16
+ scenario?: string;
17
+ step?: string;
18
+ /** The failed step's error; its message is copied into `meta.error`, without terminal color codes. */
19
+ error?: unknown;
20
+ /** The backstop around the whole capture. Defaults to 10 s. */
21
+ timeoutMs?: number;
22
+ };
23
+ export declare const SNAPSHOT_MASK_ENV = "UTAM_SNAPSHOT_MASK";
24
+ /** The walker's source text, exactly as it ships in `walker.js`. */
25
+ export declare function walkerSource(): string;
26
+ /** The options every way of running the walker shares. */
27
+ export type WalkerOptions = {
28
+ /** Defaults to `manual`. */
29
+ trigger?: SnapshotTrigger;
30
+ label?: string;
31
+ /** Defaults to `UTAM_SNAPSHOT_MASK`, then `labels`. */
32
+ mask?: SnapshotMask;
33
+ maxNodes?: number;
34
+ maxHiddenNodes?: number;
35
+ timeBudgetMs?: number;
36
+ /** `none`, `auto`, or a CSS selector. */
37
+ focus?: string;
38
+ /** Where `UTAM_SNAPSHOT_MASK` is read from. Defaults to `process.env`. */
39
+ env?: EnvLike;
40
+ /** Where warnings go. Defaults to `console.warn`. */
41
+ log?: (message: string) => void;
42
+ };
43
+ /** The default warning sink. */
44
+ export declare function warn(message: string): void;
45
+ /**
46
+ * The expression that runs the walker with these options, `(<walker>)(<options>)`, as every way of
47
+ * capturing sends it to a page. Warns through `log` when the mask is `full`.
48
+ */
49
+ export declare function walkerExpression(options: WalkerOptions): string;
50
+ /**
51
+ * Capture a DOM snapshot of the current page. Never throws: on any failure it logs a warning and
52
+ * returns `undefined`.
53
+ *
54
+ * @param options What to capture and how.
55
+ */
56
+ export declare function captureDomSnapshot(options?: CaptureDomSnapshotOptions): Promise<DomSnapshot | undefined>;
@@ -0,0 +1,115 @@
1
+ /*
2
+ * Copyright (c) 2026, SimplySF.
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+ import { readFileSync } from 'node:fs';
17
+ import { parseDomSnapshot } from './format.js';
18
+ export const SNAPSHOT_MASK_ENV = 'UTAM_SNAPSHOT_MASK';
19
+ let walkerSourceCache;
20
+ /** The walker's source text, exactly as it ships in `walker.js`. */
21
+ export function walkerSource() {
22
+ walkerSourceCache ??= readFileSync(new URL('./walker.js', import.meta.url), 'utf8');
23
+ return walkerSourceCache;
24
+ }
25
+ function browserPage(browser) {
26
+ return {
27
+ async evaluate(source) {
28
+ return String(await browser.execute(`return ${source};`));
29
+ },
30
+ };
31
+ }
32
+ function resolveMask(options) {
33
+ const value = options.mask ?? (options.env ?? process.env)[SNAPSHOT_MASK_ENV];
34
+ return value === 'structure' || value === 'aria' || value === 'full' ? value : 'labels';
35
+ }
36
+ /** The default warning sink. */
37
+ export function warn(message) {
38
+ // eslint-disable-next-line no-console -- the default sink; `log` lets a caller redirect it
39
+ console.warn(message);
40
+ }
41
+ /**
42
+ * The expression that runs the walker with these options, `(<walker>)(<options>)`, as every way of
43
+ * capturing sends it to a page. Warns through `log` when the mask is `full`.
44
+ */
45
+ export function walkerExpression(options) {
46
+ const mask = resolveMask(options);
47
+ if (mask === 'full')
48
+ (options.log ?? warn)('DOM snapshot: mask "full" keeps record data in the snapshot.');
49
+ const walkerOptions = {
50
+ trigger: options.trigger ?? 'manual',
51
+ label: options.label,
52
+ mask,
53
+ maxNodes: options.maxNodes,
54
+ maxHiddenNodes: options.maxHiddenNodes,
55
+ timeBudgetMs: options.timeBudgetMs,
56
+ focus: options.focus,
57
+ };
58
+ return `(${walkerSource()})(${JSON.stringify(walkerOptions)})`;
59
+ }
60
+ // Assertion libraries color their messages; the snapshot is read as text, not in a terminal.
61
+ // eslint-disable-next-line no-control-regex -- matching the escape character is the point
62
+ const ANSI_ESCAPE = /\u001b\[[0-9;]*m/g;
63
+ function stripAnsi(text) {
64
+ return text.replace(ANSI_ESCAPE, '');
65
+ }
66
+ function errorMessage(error) {
67
+ if (error === undefined || error === null)
68
+ return undefined;
69
+ if (error instanceof Error)
70
+ return error.message;
71
+ if (typeof error === 'object' && 'message' in error)
72
+ return String(error.message);
73
+ return typeof error === 'string' ? error : JSON.stringify(error);
74
+ }
75
+ /**
76
+ * Capture a DOM snapshot of the current page. Never throws: on any failure it logs a warning and
77
+ * returns `undefined`.
78
+ *
79
+ * @param options What to capture and how.
80
+ */
81
+ export async function captureDomSnapshot(options = {}) {
82
+ const log = options.log ?? warn;
83
+ try {
84
+ const source = walkerExpression({ ...options, log });
85
+ const timeoutMs = options.timeoutMs ?? 10_000;
86
+ let page = options.page;
87
+ if (!page) {
88
+ const browser = options.browser ?? globalThis.browser;
89
+ if (!browser || typeof browser.execute !== 'function')
90
+ throw new Error('no browser to capture');
91
+ page = browserPage(browser);
92
+ }
93
+ let timer;
94
+ const json = await Promise.race([
95
+ page.evaluate(source, timeoutMs),
96
+ new Promise((_, reject) => {
97
+ timer = setTimeout(() => reject(new Error(`timed out after ${timeoutMs} ms`)), timeoutMs);
98
+ }),
99
+ ]).finally(() => clearTimeout(timer));
100
+ const snapshot = parseDomSnapshot(json);
101
+ if (options.scenario)
102
+ snapshot.meta.scenario = options.scenario;
103
+ if (options.step)
104
+ snapshot.meta.step = options.step;
105
+ const message = errorMessage(options.error);
106
+ if (message !== undefined)
107
+ snapshot.meta.error = stripAnsi(message);
108
+ return snapshot;
109
+ }
110
+ catch (error) {
111
+ log(`DOM snapshot not captured: ${errorMessage(error) ?? 'unknown error'}`);
112
+ return undefined;
113
+ }
114
+ }
115
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/snapshot/capture.ts"],"names":[],"mappings":"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"}