@pantheon-systems/pds-toolkit-react 2.0.0-alpha.6 → 2.0.0-alpha.61

package/bin/pds-codemod.cjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const [, , transformName, ...targetPaths] = process.argv;
+
+if (!transformName) {
+	console.error('Usage: pds-codemod <transform-name> <path>');
+	console.error('\nAvailable transforms:');
+	const transformsDir = path.join(__dirname, '../codemods/v1-to-v2/transforms');
+	fs.readdirSync(transformsDir)
+		.filter((f) => f.endsWith('.js') && !f.startsWith('_'))
+		.forEach((f) => console.error(`  ${f.replace('.js', '')}`));
+	process.exit(1);
+}
+
+if (targetPaths.length === 0) {
+	console.error('Usage: pds-codemod <transform-name> <path>');
+	process.exit(1);
+}
+
+const transformPath = path.join(
+	__dirname,
+	'../codemods/v1-to-v2/transforms',
+	`${transformName}.js`,
+);
+
+if (!fs.existsSync(transformPath)) {
+	console.error(`Unknown transform: "${transformName}"`);
+	console.error('\nAvailable transforms:');
+	const transformsDir = path.join(__dirname, '../codemods/v1-to-v2/transforms');
+	fs.readdirSync(transformsDir)
+		.filter((f) => f.endsWith('.js') && !f.startsWith('_'))
+		.forEach((f) => console.error(`  ${f.replace('.js', '')}`));
+	process.exit(1);
+}
+
+const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+
+try {
+	execFileSync(
+		npx,
+		[
+			'jscodeshift',
+			'-t',
+			transformPath,
+			'--extensions=tsx,ts,jsx,js',
+			...targetPaths,
+		],
+		{ stdio: 'inherit' },
+	);
+} catch {
+	process.exit(1);
+}

package/codemods/v1-to-v2/css-token-renames.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * css-token-renames
+ *
+ * Find-and-replace script for PDS design token renames in CSS and SCSS files.
+ * Driven entirely by tokens.renames and tokens.patterns in the published
+ * @pantheon-systems/pds-design-tokens codemods mappings.
+ *
+ * Handles:
+ *   - Exact token renames: --pds-old-name → --pds-new-name
+ *   - Wildcard patterns:   --pds-badge-*-secondary → --pds-badge-*-muted
+ *   - CSS utility classes: pds-color-bg-default → pds-color-surface-default
+ *     (in CSS selectors; JSX className usage is handled by css-class-renames)
+ *
+ * Usage (from a consuming app, after installing @pantheon-systems/pds-toolkit-react):
+ *   node node_modules/@pantheon-systems/pds-toolkit-react/codemods/v1-to-v2/css-token-renames.js <path>
+ *   node node_modules/@pantheon-systems/pds-toolkit-react/codemods/v1-to-v2/css-token-renames.js src/apps/workspace/
+ *
+ * Usage (from a local checkout of this repo):
+ *   node codemods/v1-to-v2/css-token-renames.js <path>
+ *
+ * Options:
+ *   --dry             Preview changes without writing files
+ *   --only=<category> Restrict to a token category (e.g. animation, color, spacing)
+ *   --ext=css,scss    File extensions to scan (default: css,scss)
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { createRequire } from 'module';
+import { globSync } from 'glob';
+
+// JSON imports via createRequire — works in both CJS and ESM contexts
+const require = createRequire(import.meta.url);
+const mappings = require('@pantheon-systems/pds-design-tokens/codemods/v1-to-v2/mappings.json');
+
+// --- Argument parsing ---
+
+const args = process.argv.slice(2);
+const dry = args.includes('--dry');
+const onlyArg = args.find((a) => a.startsWith('--only='));
+const extArg = args.find((a) => a.startsWith('--ext='));
+const targetPaths = args.filter((a) => !a.startsWith('--'));
+
+const onlyCategory = onlyArg ? onlyArg.replace('--only=', '').trim() : null;
+const extensions = extArg
+	? extArg
+			.replace('--ext=', '')
+			.split(',')
+			.map((e) => e.trim())
+	: ['css', 'scss'];
+
+if (targetPaths.length === 0) {
+	console.error(
+		'Usage: node codemods/v1-to-v2/css-token-renames.js <path> [--dry] [--only=category] [--ext=css,scss]',
+	);
+	process.exit(1);
+}
+
+// --- Build rename and pattern lists ---
+
+function buildRenames() {
+	const exact = []; // { from, to }
+	const patterns = []; // { regex, replacement, from }
+
+	for (const entry of mappings.tokens.renames) {
+		if (!entry.from || !entry.to || entry.from === entry.to) continue;
+		if (onlyCategory && entry.category !== onlyCategory) continue;
+		exact.push({ from: entry.from, to: entry.to });
+	}
+
+	for (const entry of mappings.tokens.patterns) {
+		if (!entry.from || !entry.to || entry.from === entry.to) continue;
+		if (onlyCategory && entry.category !== onlyCategory) continue;
+
+		// Convert wildcard pattern to regex.
+		// Escape special regex chars except *, then replace * with a capture group.
+		const escaped = entry.from
+			.replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+			.replace(/\*/g, '([\\w-]+)');
+		const regex = new RegExp(escaped, 'g');
+
+		// Build replacement — each * in `to` becomes $1, $2, etc.
+		let captureIndex = 0;
+		const replacement = entry.to.replace(/\*/g, () => `$${++captureIndex}`);
+
+		patterns.push({ regex, replacement, from: entry.from });
+	}
+
+	return { exact, patterns };
+}
+
+const { exact: EXACT_RENAMES, patterns: PATTERNS } = buildRenames();
+
+// --- File discovery ---
+
+function findFiles(targetPath) {
+	const extPattern =
+		extensions.length === 1 ? extensions[0] : `{${extensions.join(',')}}`;
+
+	if (fs.existsSync(targetPath) && fs.statSync(targetPath).isFile()) {
+		return [targetPath];
+	}
+
+	if (fs.existsSync(targetPath) && fs.statSync(targetPath).isDirectory()) {
+		return globSync(`**/*.${extPattern}`, {
+			cwd: targetPath,
+			absolute: true,
+			ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+		});
+	}
+
+	return globSync(targetPath, {
+		absolute: true,
+		ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+	});
+}
+
+// --- Apply renames to file content ---
+
+function applyRenames(content) {
+	let result = content;
+	let changed = false;
+	const appliedRenames = [];
+
+	// Exact renames
+	for (const { from, to } of EXACT_RENAMES) {
+		if (!result.includes(from)) continue;
+		const regex = new RegExp(from.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g');
+		const next = result.replace(regex, to);
+		if (next !== result) {
+			appliedRenames.push(`  ${from} → ${to}`);
+			result = next;
+			changed = true;
+		}
+	}
+
+	// Wildcard patterns
+	for (const { regex, replacement, from } of PATTERNS) {
+		regex.lastIndex = 0;
+		const next = result.replace(regex, replacement);
+		if (next !== result) {
+			appliedRenames.push(`  ${from} → ${replacement} (pattern)`);
+			result = next;
+			changed = true;
+		}
+	}
+
+	return { result, changed, appliedRenames };
+}
+
+// --- Main ---
+
+let totalFiles = 0;
+let changedFiles = 0;
+let totalRenames = 0;
+
+const allFiles = targetPaths.flatMap(findFiles);
+
+if (allFiles.length === 0) {
+	console.log('No CSS/SCSS files found matching the given path(s).');
+	process.exit(0);
+}
+
+for (const filePath of allFiles) {
+	const content = fs.readFileSync(filePath, 'utf8');
+	const { result, changed, appliedRenames } = applyRenames(content);
+
+	totalFiles++;
+	if (!changed) continue;
+
+	changedFiles++;
+	totalRenames += appliedRenames.length;
+
+	console.log(
+		`${dry ? '[dry] ' : ''}${path.relative(process.cwd(), filePath)}`,
+	);
+	appliedRenames.forEach((r) => console.log(r));
+
+	if (!dry) fs.writeFileSync(filePath, result, 'utf8');
+}
+
+console.log(
+	`\n${dry ? '[dry run] ' : ''}${changedFiles}/${totalFiles} files changed, ${totalRenames} renames applied.`,
+);
+if (dry && changedFiles > 0) console.log('Run without --dry to apply changes.');