@simplysf/simply-utam-core 0.0.0 → 0.1.0

package/lib/overrides/overrides-merger.js.map

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

package/lib/rules/index.d.ts

@@ -0,0 +1 @@
+export * from './rules-generator.js';

package/lib/rules/index.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './rules-generator.js';
+//# sourceMappingURL=index.js.map

package/lib/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,sBAAsB,CAAC"}

package/lib/rules/rules-generator.d.ts

@@ -0,0 +1,49 @@
+export declare const ROOT_TARGETS: readonly ["lightningCommunity__Page", "lightning__AppPage", "lightning__HomePage", "lightning__RecordPage"];
+export interface GenerateRulesOptions {
+    rootDir?: string;
+    sourceDirs?: string[];
+    namespace?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export interface RuleAction {
+    componentName: string;
+    componentDir: string;
+    rulesFilePath: string;
+    selector: string;
+    action: 'created' | 'updated' | 'skipped';
+    reason?: string;
+}
+export interface GenerateRulesResult {
+    totalComponentsScanned: number;
+    rootComponentsIdentified: number;
+    filesCreated: string[];
+    filesUpdated: string[];
+    dryRun: boolean;
+    actions: RuleAction[];
+}
+/**
+ * Converts camelCase or PascalCase component name to kebab-case HTML tag with namespace prefix.
+ * e.g., myComponent -> c-my-component, sampleHome with namespace 'custom' -> custom-sample-home
+ *
+ * @param componentName - The LWC component name.
+ * @param namespace - Optional packaging namespace.
+ * @returns Kebab-cased HTML tag name.
+ */
+export declare function convertLwcNameToHtml(componentName: string, namespace?: string | null): string;
+/**
+ * Parses targets inside <targets>...</targets> block in a js-meta.xml content,
+ * stripping XML comments to avoid matching commented-out targets.
+ *
+ * @param xmlContent - Raw XML content string of the js-meta.xml file.
+ * @returns Array of target string identifiers.
+ */
+export declare function getTargetsFromMeta(xmlContent: string): string[];
+/**
+ * Scans discovered LWC components, identifies root targets, and creates or updates
+ * <componentName>.rules.json files.
+ *
+ * @param options - Rules generation options.
+ * @returns Results describing scanned components and generated rules files.
+ */
+export declare function generateLwcRules(options?: GenerateRulesOptions): GenerateRulesResult;

package/lib/rules/rules-generator.js

@@ -0,0 +1,199 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { discoverProject, findLwcDirectories } from '../discovery/index.js';
+export const ROOT_TARGETS = [
+    'lightningCommunity__Page',
+    'lightning__AppPage',
+    'lightning__HomePage',
+    'lightning__RecordPage',
+];
+/**
+ * Converts camelCase or PascalCase component name to kebab-case HTML tag with namespace prefix.
+ * e.g., myComponent -> c-my-component, sampleHome with namespace 'custom' -> custom-sample-home
+ *
+ * @param componentName - The LWC component name.
+ * @param namespace - Optional packaging namespace.
+ * @returns Kebab-cased HTML tag name.
+ */
+export function convertLwcNameToHtml(componentName, namespace) {
+    if (!componentName?.trim()) {
+        return '';
+    }
+    const cleanName = componentName.trim();
+    let kebab = cleanName.replace(/([A-Z])/g, '-$1').toLowerCase();
+    if (kebab.startsWith('-')) {
+        kebab = kebab.substring(1);
+    }
+    const prefix = namespace?.trim() ? namespace.trim() : 'c';
+    return `${prefix}-${kebab}`;
+}
+/**
+ * Parses targets inside <targets>...</targets> block in a js-meta.xml content,
+ * stripping XML comments to avoid matching commented-out targets.
+ *
+ * @param xmlContent - Raw XML content string of the js-meta.xml file.
+ * @returns Array of target string identifiers.
+ */
+export function getTargetsFromMeta(xmlContent) {
+    // Strip XML comments
+    const cleanXml = xmlContent.replace(/<!--[\s\S]*?-->/g, '');
+    const targetsMatch = cleanXml.match(/<targets(?:\s[^>]*)?>([\s\S]*?)<\/targets>/);
+    if (!targetsMatch) {
+        return [];
+    }
+    const targetsSection = targetsMatch[1];
+    const targetMatches = [...targetsSection.matchAll(/<target(?:\s[^>]*)?>([\s\S]*?)<\/target>/g)];
+    return targetMatches.map((match) => match[1].trim()).filter(Boolean);
+}
+function processComponentRules(componentDir, componentName, namespace, dryRun) {
+    const rulesFilePath = path.join(componentDir, `${componentName}.rules.json`);
+    const metaFilePath = path.join(componentDir, `${componentName}.js-meta.xml`);
+    if (!fs.existsSync(metaFilePath)) {
+        return {
+            componentName,
+            componentDir,
+            rulesFilePath,
+            selector: '',
+            action: 'skipped',
+            reason: 'Missing js-meta.xml file',
+        };
+    }
+    let xmlContent;
+    try {
+        xmlContent = fs.readFileSync(metaFilePath, 'utf-8');
+    }
+    catch {
+        return {
+            componentName,
+            componentDir,
+            rulesFilePath,
+            selector: '',
+            action: 'skipped',
+            reason: 'Failed to read js-meta.xml file',
+        };
+    }
+    const targets = getTargetsFromMeta(xmlContent);
+    const isRoot = targets.some((target) => ROOT_TARGETS.includes(target));
+    if (!isRoot) {
+        return {
+            componentName,
+            componentDir,
+            rulesFilePath,
+            selector: '',
+            action: 'skipped',
+            reason: `Not a root component (targets: ${targets.join(', ') || 'none'})`,
+        };
+    }
+    const selector = convertLwcNameToHtml(componentName, namespace);
+    let rulesJson = {};
+    let isExisting = false;
+    if (fs.existsSync(rulesFilePath)) {
+        isExisting = true;
+        try {
+            rulesJson = JSON.parse(fs.readFileSync(rulesFilePath, 'utf-8'));
+        }
+        catch {
+            rulesJson = {};
+        }
+    }
+    rulesJson.root = true;
+    if (!rulesJson.selector || typeof rulesJson.selector !== 'object') {
+        rulesJson.selector = {};
+    }
+    rulesJson.selector.css = selector;
+    if (!dryRun) {
+        const jsonString = JSON.stringify(rulesJson, null, 2) + '\n';
+        fs.writeFileSync(rulesFilePath, jsonString, 'utf-8');
+    }
+    return {
+        componentName,
+        componentDir,
+        rulesFilePath,
+        selector,
+        action: isExisting ? 'updated' : 'created',
+    };
+}
+function scanLwcDirRules(lwcDir, namespace, dryRun, result) {
+    let entries;
+    try {
+        entries = fs.readdirSync(lwcDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const componentName = entry.name;
+        if (componentName.startsWith('.') || componentName === '__tests__') {
+            continue;
+        }
+        result.totalComponentsScanned++;
+        const action = processComponentRules(path.join(lwcDir, componentName), componentName, namespace, dryRun);
+        if (action.action === 'created') {
+            result.rootComponentsIdentified++;
+            result.filesCreated.push(action.rulesFilePath);
+        }
+        else if (action.action === 'updated') {
+            result.rootComponentsIdentified++;
+            result.filesUpdated.push(action.rulesFilePath);
+        }
+        result.actions.push(action);
+    }
+}
+/**
+ * Scans discovered LWC components, identifies root targets, and creates or updates
+ * <componentName>.rules.json files.
+ *
+ * @param options - Rules generation options.
+ * @returns Results describing scanned components and generated rules files.
+ */
+export function generateLwcRules(options = {}) {
+    const rootDir = path.resolve(options.rootDir ?? process.cwd());
+    const dryRun = Boolean(options.dryRun);
+    let sourceDirs = options.sourceDirs;
+    let namespace = options.namespace;
+    if (!sourceDirs || sourceDirs.length === 0 || namespace === undefined) {
+        const discovered = discoverProject(rootDir);
+        if (!sourceDirs || sourceDirs.length === 0) {
+            sourceDirs = discovered.packageDirectories.length > 0 ? discovered.packageDirectories : ['./sfdx-source'];
+        }
+        namespace ??= discovered.namespace ?? undefined;
+    }
+    const result = {
+        totalComponentsScanned: 0,
+        rootComponentsIdentified: 0,
+        filesCreated: [],
+        filesUpdated: [],
+        dryRun,
+        actions: [],
+    };
+    for (const sourceDir of sourceDirs) {
+        const resolvedSource = path.isAbsolute(sourceDir) ? sourceDir : path.resolve(rootDir, sourceDir);
+        if (!fs.existsSync(resolvedSource)) {
+            continue;
+        }
+        const lwcDirs = findLwcDirectories(resolvedSource);
+        for (const lwcDir of lwcDirs) {
+            scanLwcDirRules(lwcDir, namespace, dryRun, result);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=rules-generator.js.map

package/lib/rules/rules-generator.js.map

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

package/lib/scaffold/index.d.ts

@@ -0,0 +1 @@
+export * from './project-scaffolder.js';

package/lib/scaffold/index.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './project-scaffolder.js';
+//# sourceMappingURL=index.js.map

package/lib/scaffold/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,yBAAyB,CAAC"}

package/lib/scaffold/project-scaffolder.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Default location of external scaffold template files.
+ * Resolves to the templates directory in @simplysf/simply-utam-core whether in src or lib.
+ */
+export declare const DEFAULT_TEMPLATES_DIR: string;
+/**
+ * Standard recommended devDependencies for consuming UTAM with SimplyUTAM.
+ */
+export declare const DEFAULT_REQUIRED_DEV_DEPENDENCIES: string[];
+/**
+ * Options for project scaffolding.
+ */
+export interface ScaffoldOptions {
+    /**
+     * Root directory of the consumer project. Defaults to current working directory.
+     */
+    projectDir?: string;
+    /**
+     * Primary Salesforce source directory. If not specified, automatically detected from sfdx-project.json.
+     */
+    sourceDir?: string;
+    /**
+     * Application name / namespace used in UTAM generator namespaces and namespace maps.
+     */
+    appName?: string;
+    /**
+     * Directory containing external template files. Defaults to the package's templates/ folder.
+     */
+    templatesDir?: string;
+    /**
+     * If true, previews planned file changes without writing to disk.
+     */
+    dryRun?: boolean;
+    /**
+     * If true, forces overwriting of existing config files.
+     */
+    force?: boolean;
+}
+/**
+ * Result details from executing project scaffolding.
+ */
+export interface ScaffoldResult {
+    /**
+     * Paths of files newly created on disk.
+     */
+    createdFiles: string[];
+    /**
+     * Paths of existing files that were preserved without overwrite.
+     */
+    skippedFiles: string[];
+    /**
+     * Paths of existing files that were updated (such as package.json).
+     */
+    modifiedFiles: string[];
+    /**
+     * The updated package.json representation, if modified.
+     */
+    updatedPackageJson?: Record<string, unknown>;
+    /**
+     * List of recommended devDependencies missing from the consumer's package.json.
+     */
+    missingDependencies: string[];
+}
+/**
+ * Loads an external template file from disk, performing token replacements.
+ *
+ * @param templateName - The filename of the template to load.
+ * @param templatesDir - The directory containing template files.
+ * @param tokens - Key-value replacements for {{token}} placeholders.
+ * @returns The resolved template content string.
+ * @throws If the template file does not exist.
+ */
+export declare function loadTemplate(templateName: string, templatesDir?: string, tokens?: Record<string, string>): string;
+/**
+ * Generates the generator.config.json content by loading its external template.
+ *
+ * @param sourceDir - The Salesforce source directory.
+ * @param appName - The application namespace name.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for generator.config.json.
+ */
+export declare function generateGeneratorConfig(sourceDir: string, appName: string, templatesDir?: string): Record<string, unknown>;
+/**
+ * Generates the utam.config.json content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for utam.config.json.
+ */
+export declare function generateUtamConfig(templatesDir?: string): Record<string, unknown>;
+/**
+ * Generates the wdio.conf.mjs configuration script content by loading its external template.
+ *
+ * @param sourceDir - The primary Salesforce source directory.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted JavaScript module text for wdio.conf.mjs.
+ */
+export declare function generateWdioConfig(sourceDir: string, templatesDir?: string): string;
+/**
+ * Generates the .utam/namespace-map.json content by loading its external template.
+ *
+ * @param appName - The application namespace name.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Parsed JSON object for namespace-map.json.
+ */
+export declare function generateNamespaceMap(appName: string, templatesDir?: string): Record<string, unknown>;
+/**
+ * Generates the hello.feature starter Gherkin feature file content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted Gherkin feature file text for hello.feature.
+ */
+export declare function generateHelloFeature(templatesDir?: string): string;
+/**
+ * Generates the hello.steps.mjs starter Cucumber step definition script content by loading its external template.
+ *
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns Formatted JavaScript module text for hello.steps.mjs.
+ */
+export declare function generateHelloSteps(templatesDir?: string): string;
+/**
+ * Non-destructively injects standard UTAM Wireit scripts and task configurations into a package.json object.
+ * Loads task definitions from external wireit.json template.
+ *
+ * @param packageJson - The existing package.json object.
+ * @param templatesDir - Optional custom directory containing the template file.
+ * @returns An object containing the modified package.json and lists of added keys.
+ */
+export declare function injectWireitConfiguration(packageJson: Record<string, unknown>, templatesDir?: string): {
+    updated: boolean;
+    packageJson: Record<string, unknown>;
+    addedScripts: string[];
+    addedTasks: string[];
+};
+/**
+ * Checks a package.json object for missing recommended devDependencies.
+ *
+ * @param packageJson - The target package.json object.
+ * @param requiredDependencies - Optional list of required dependency names.
+ * @returns Array of dependency names missing from both devDependencies and dependencies.
+ */
+export declare function checkMissingDependencies(packageJson: Record<string, unknown>, requiredDependencies?: string[]): string[];
+/**
+ * Scaffolds standard UTAM configurations, Wireit tasks, and namespace maps in a project directory.
+ *
+ * @param options - Scaffolding options.
+ * @returns Results describing created, skipped, and modified files.
+ */
+export declare function scaffoldProject(options?: ScaffoldOptions): Promise<ScaffoldResult>;