249 lines
9.3 KiB
JavaScript
249 lines
9.3 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* sync-brand-to-tokens.cjs
|
||
*
|
||
* Syncs brand-guidelines.md colors → design-tokens.json → design-tokens.css
|
||
*
|
||
* Usage:
|
||
* node sync-brand-to-tokens.cjs
|
||
* node sync-brand-to-tokens.cjs --dry-run
|
||
*/
|
||
|
||
const fs = require('fs');
|
||
const path = require('path');
|
||
const { execFileSync } = require('child_process');
|
||
|
||
// Paths
|
||
const BRAND_GUIDELINES = 'docs/brand-guidelines.md';
|
||
const DESIGN_TOKENS_JSON = 'assets/design-tokens.json';
|
||
const DESIGN_TOKENS_CSS = 'assets/design-tokens.css';
|
||
const GENERATE_TOKENS_SCRIPT = '.claude/skills/design-system/scripts/generate-tokens.cjs';
|
||
|
||
/**
|
||
* Extract color info from brand guidelines markdown
|
||
*/
|
||
function extractColorsFromMarkdown(content) {
|
||
const colors = {
|
||
primary: { name: 'primary', shades: {} },
|
||
secondary: { name: 'secondary', shades: {} },
|
||
accent: { name: 'accent', shades: {} }
|
||
};
|
||
|
||
// Match a "| Label | #hex |" markdown table row. Bold around the label
|
||
// (**Label**) is optional, so this handles both the bundled starter template
|
||
// ("| Primary Blue | #2563EB |") and bolded variants.
|
||
const rowRe = /\|\s*\*{0,2}([^*|]+?)\*{0,2}\s*\|\s*#([A-Fa-f0-9]{6})\b/g;
|
||
|
||
// 1) Quick Reference table — hex only, no parenthesized name required.
|
||
const quickRef = {
|
||
primary: /Primary Color\s*\|\s*#([A-Fa-f0-9]{6})/i,
|
||
secondary: /Secondary Color\s*\|\s*#([A-Fa-f0-9]{6})/i,
|
||
accent: /Accent Color\s*\|\s*#([A-Fa-f0-9]{6})/i
|
||
};
|
||
for (const key of Object.keys(quickRef)) {
|
||
const m = content.match(quickRef[key]);
|
||
if (m) colors[key].base = `#${m[1]}`;
|
||
}
|
||
|
||
// 2) Dedicated "### <Role> Colors" tables — assign base/dark/light by the
|
||
// row label keyword.
|
||
const assignFromSection = (heading, target) => {
|
||
const section = content.match(new RegExp(`### ${heading}[\\s\\S]*?(?=\\n###|$)`, 'i'));
|
||
if (!section) return;
|
||
for (const m of section[0].matchAll(rowRe)) {
|
||
const label = m[1].trim().toLowerCase();
|
||
const hex = `#${m[2]}`;
|
||
if (label.includes('dark')) target.dark = hex;
|
||
else if (label.includes('light')) target.light = hex;
|
||
else if (!target.base) target.base = hex;
|
||
}
|
||
};
|
||
assignFromSection('Primary Colors', colors.primary);
|
||
assignFromSection('Secondary Colors', colors.secondary);
|
||
assignFromSection('Accent Colors', colors.accent);
|
||
|
||
// 3) Fallback: an accent swatch may live in another table (the starter
|
||
// lists "Accent Green" under Secondary Colors).
|
||
if (!colors.accent.base) {
|
||
for (const m of content.matchAll(rowRe)) {
|
||
if (m[1].trim().toLowerCase().includes('accent')) {
|
||
colors.accent.base = `#${m[2]}`;
|
||
break;
|
||
}
|
||
}
|
||
}
|
||
|
||
return colors;
|
||
}
|
||
|
||
/**
|
||
* Generate color scale from base color (simple approach)
|
||
*/
|
||
function generateColorScale(baseHex, darkHex, lightHex) {
|
||
// Use provided shades or generate approximations
|
||
return {
|
||
"50": { "$value": lightHex || adjustBrightness(baseHex, 0.9), "$type": "color" },
|
||
"100": { "$value": lightHex || adjustBrightness(baseHex, 0.8), "$type": "color" },
|
||
"200": { "$value": adjustBrightness(baseHex, 0.6), "$type": "color" },
|
||
"300": { "$value": adjustBrightness(baseHex, 0.4), "$type": "color" },
|
||
"400": { "$value": adjustBrightness(baseHex, 0.2), "$type": "color" },
|
||
"500": { "$value": baseHex, "$type": "color" },
|
||
"600": { "$value": darkHex || adjustBrightness(baseHex, -0.15), "$type": "color" },
|
||
"700": { "$value": adjustBrightness(baseHex, -0.3), "$type": "color" },
|
||
"800": { "$value": adjustBrightness(baseHex, -0.45), "$type": "color" },
|
||
"900": { "$value": adjustBrightness(baseHex, -0.6), "$type": "color" }
|
||
};
|
||
}
|
||
|
||
/**
|
||
* Adjust hex color brightness
|
||
*/
|
||
function adjustBrightness(hex, percent) {
|
||
if (typeof hex !== 'string') return '#000000';
|
||
const num = parseInt(hex.replace('#', ''), 16);
|
||
const r = Math.min(255, Math.max(0, (num >> 16) + Math.round(255 * percent)));
|
||
const g = Math.min(255, Math.max(0, ((num >> 8) & 0x00FF) + Math.round(255 * percent)));
|
||
const b = Math.min(255, Math.max(0, (num & 0x0000FF) + Math.round(255 * percent)));
|
||
return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, '0').toUpperCase()}`;
|
||
}
|
||
|
||
/**
|
||
* Update design tokens JSON
|
||
*/
|
||
function updateDesignTokens(tokens, colors) {
|
||
// Update brand name
|
||
const brandName = `ClaudeKit Marketing - ${colors.primary.name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}`;
|
||
tokens.brand = brandName;
|
||
|
||
// Update primitive colors with new names
|
||
tokens.primitive = tokens.primitive || {};
|
||
const primitiveColors = tokens.primitive.color || {};
|
||
|
||
// Remove old color keys, add new ones
|
||
delete primitiveColors.coral;
|
||
delete primitiveColors.purple;
|
||
delete primitiveColors.mint;
|
||
|
||
// Add new named colors. Skip any role with no base hex rather than crashing
|
||
// on an unexpected guidelines format.
|
||
for (const role of ['primary', 'secondary', 'accent']) {
|
||
const c = colors[role];
|
||
if (!c.base) {
|
||
console.warn(`⚠️ No base hex found for ${role} color — skipping its token scale.`);
|
||
continue;
|
||
}
|
||
primitiveColors[c.name] = generateColorScale(c.base, c.dark, c.light);
|
||
}
|
||
|
||
tokens.primitive.color = primitiveColors;
|
||
|
||
// Update ALL semantic color references
|
||
if (tokens.semantic?.color) {
|
||
const sem = tokens.semantic.color;
|
||
const p = colors.primary.name;
|
||
const s = colors.secondary.name;
|
||
const a = colors.accent.name;
|
||
|
||
// Primary variants
|
||
sem.primary = { "$value": `{primitive.color.${p}.500}`, "$type": "color" };
|
||
sem['primary-hover'] = { "$value": `{primitive.color.${p}.600}`, "$type": "color" };
|
||
sem['primary-active'] = { "$value": `{primitive.color.${p}.700}`, "$type": "color" };
|
||
sem['primary-light'] = { "$value": `{primitive.color.${p}.400}`, "$type": "color" };
|
||
sem['primary-lighter'] = { "$value": `{primitive.color.${p}.100}`, "$type": "color" };
|
||
sem['primary-dark'] = { "$value": `{primitive.color.${p}.600}`, "$type": "color" };
|
||
|
||
// Secondary variants
|
||
sem.secondary = { "$value": `{primitive.color.${s}.500}`, "$type": "color" };
|
||
sem['secondary-hover'] = { "$value": `{primitive.color.${s}.600}`, "$type": "color" };
|
||
sem['secondary-light'] = { "$value": `{primitive.color.${s}.300}`, "$type": "color" };
|
||
sem['secondary-dark'] = { "$value": `{primitive.color.${s}.600}`, "$type": "color" };
|
||
|
||
// Accent variants
|
||
sem.accent = { "$value": `{primitive.color.${a}.500}`, "$type": "color" };
|
||
sem['accent-hover'] = { "$value": `{primitive.color.${a}.600}`, "$type": "color" };
|
||
sem['accent-light'] = { "$value": `{primitive.color.${a}.300}`, "$type": "color" };
|
||
|
||
// Status colors (use accent for success, primary for error/info)
|
||
sem.success = { "$value": `{primitive.color.${a}.500}`, "$type": "color" };
|
||
sem['success-light'] = { "$value": `{primitive.color.${a}.300}`, "$type": "color" };
|
||
sem.error = { "$value": `{primitive.color.${p}.500}`, "$type": "color" };
|
||
sem['error-light'] = { "$value": `{primitive.color.${p}.300}`, "$type": "color" };
|
||
sem.info = { "$value": `{primitive.color.${s}.500}`, "$type": "color" };
|
||
sem['info-light'] = { "$value": `{primitive.color.${s}.300}`, "$type": "color" };
|
||
}
|
||
|
||
// Update component references (button uses primary color with opacity)
|
||
if (tokens.component?.button?.secondary && colors.primary.base) {
|
||
const primaryBase = colors.primary.base;
|
||
tokens.component.button.secondary['bg-hover'] = {
|
||
"$value": `${primaryBase}1A`,
|
||
"$type": "color"
|
||
};
|
||
}
|
||
|
||
return tokens;
|
||
}
|
||
|
||
/**
|
||
* Main
|
||
*/
|
||
function main() {
|
||
const dryRun = process.argv.includes('--dry-run');
|
||
|
||
console.log('🔄 Syncing brand guidelines → design tokens\n');
|
||
|
||
// Read brand guidelines
|
||
const guidelinesPath = path.resolve(process.cwd(), BRAND_GUIDELINES);
|
||
if (!fs.existsSync(guidelinesPath)) {
|
||
console.error(`❌ Brand guidelines not found: ${guidelinesPath}`);
|
||
process.exit(1);
|
||
}
|
||
const guidelinesContent = fs.readFileSync(guidelinesPath, 'utf-8');
|
||
|
||
// Extract colors
|
||
const colors = extractColorsFromMarkdown(guidelinesContent);
|
||
console.log('📊 Extracted colors:');
|
||
console.log(` Primary: ${colors.primary.name} (${colors.primary.base})`);
|
||
console.log(` Secondary: ${colors.secondary.name} (${colors.secondary.base})`);
|
||
console.log(` Accent: ${colors.accent.name} (${colors.accent.base})\n`);
|
||
|
||
// Read existing tokens
|
||
const tokensPath = path.resolve(process.cwd(), DESIGN_TOKENS_JSON);
|
||
let tokens = {};
|
||
if (fs.existsSync(tokensPath)) {
|
||
tokens = JSON.parse(fs.readFileSync(tokensPath, 'utf-8'));
|
||
}
|
||
|
||
// Update tokens
|
||
tokens = updateDesignTokens(tokens, colors);
|
||
|
||
if (dryRun) {
|
||
console.log('📋 Would update design-tokens.json:');
|
||
console.log(JSON.stringify(tokens.primitive.color, null, 2).slice(0, 500) + '...');
|
||
console.log('\n⏭️ Dry run - no files changed');
|
||
return;
|
||
}
|
||
|
||
// Write updated tokens
|
||
fs.writeFileSync(tokensPath, JSON.stringify(tokens, null, 2));
|
||
console.log(`✅ Updated: ${DESIGN_TOKENS_JSON}`);
|
||
|
||
// Regenerate CSS
|
||
const generateScript = path.resolve(process.cwd(), GENERATE_TOKENS_SCRIPT);
|
||
if (fs.existsSync(generateScript)) {
|
||
try {
|
||
execFileSync('node', [generateScript, '--config', DESIGN_TOKENS_JSON, '-o', DESIGN_TOKENS_CSS], {
|
||
cwd: process.cwd(),
|
||
stdio: 'inherit'
|
||
});
|
||
console.log(`✅ Regenerated: ${DESIGN_TOKENS_CSS}`);
|
||
} catch (e) {
|
||
console.error('⚠️ Failed to regenerate CSS:', e.message);
|
||
}
|
||
}
|
||
|
||
console.log('\n✨ Brand sync complete!');
|
||
}
|
||
|
||
main();
|