windowpp 0.1.1 → 0.1.3

package/lib/create.js

@@ -1,283 +1,98 @@
-#!/usr/bin/env node
-// cli/lib/create.js — WindowPP app scaffolding
-//
-// Copies a template from cli/templates/<template>/ to <outDir>/<name>/,
-// substituting {{APP_NAME}}, {{APP_TITLE}}, and {{CMAKE_TARGET}} in all
-// text files.  Each created app is a self-contained project; it does NOT
-// need to live inside the framework repo.
-//
-// Usage (via CLI):
-//   windowpp create my-app [--template solid] [--out-dir .]
-
-'use strict';
-
-const path = require('path');
-const fs = require('fs');
-const { execSync } = require('child_process');
-
-function create(name, options = {}) {
-    const {
-        template = 'solid',
-        outDir = process.cwd(),
-        installDeps = true,
-    } = options;
-
-    if (!name || !/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name)) {
-        console.error('Error: app name must start with a letter and contain only letters, digits, hyphens or underscores.');
-        process.exit(1);
-    }
-
-    const appDir = path.join(outDir, name);
-    if (fs.existsSync(appDir)) {
-        console.error(`Error: directory "${appDir}" already exists.`);
-        process.exit(1);
-    }
-
-    const cliDir = path.resolve(__dirname, '..');
-    const templateDir = path.join(cliDir, 'templates', template);
-    if (!fs.existsSync(templateDir)) {
-        console.error(`Error: template "${template}" not found in ${path.join(cliDir, 'templates')}`);
-        process.exit(1);
-    }
-
-    const cmakeTarget = name.replace(/-/g, '_');
-    const appTitle = name
-        .split(/[-_]/)
-        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-        .join(' ');
-
-    const tokens = {
-        '{{APP_NAME}}':     name,
-        '{{APP_TITLE}}':    appTitle,
-        '{{CMAKE_TARGET}}': cmakeTarget,
-    };
-
-    console.log(`\n=== WindowPP Create — ${name} (template: ${template}) ===\n`);
-    console.log(`Scaffolding into: ${appDir}\n`);
-
-    // ── Copy template ─────────────────────────────────────────────────────────
-    copyDir(templateDir, appDir, tokens);
-
-    // ── Install frontend deps ─────────────────────────────────────────────────
-    const frontendDir = path.join(appDir, 'frontend');
-    if (installDeps && fs.existsSync(frontendDir)) {
-        console.log('Installing frontend dependencies...');
-        execSync('npm install', { cwd: frontendDir, stdio: 'inherit' });
-    }
-
-    console.log(`\n✓ Created "${name}"\n`);
-    console.log('Next steps:');
-    console.log(`  cd ${name}`);
-    console.log('  windowpp dev\n');
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function copyDir(src, dest, tokens) {
-    fs.mkdirSync(dest, { recursive: true });
-    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-        const srcPath  = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
-        if (entry.isDirectory()) {
-            copyDir(srcPath, destPath, tokens);
-        } else {
-            copyFile(srcPath, destPath, tokens);
-        }
-    }
-}
-
-const TEXT_EXTENSIONS = new Set([
-    '.cpp', '.h', '.ts', '.tsx', '.js', '.json', '.html',
-    '.css', '.md', '.txt', '.cmake', '.sh', '.env',
-]);
-
-function copyFile(src, dest, tokens) {
-    const ext = path.extname(src).toLowerCase();
-    if (TEXT_EXTENSIONS.has(ext)) {
-        let content = fs.readFileSync(src, 'utf8');
-        for (const [token, value] of Object.entries(tokens)) {
-            content = content.split(token).join(value);
-        }
-        fs.writeFileSync(dest, content, 'utf8');
-    } else {
-        fs.copyFileSync(src, dest);
-    }
-}
-
-module.exports = { create };
-
-
-function create(name, options = {}) {
-    const {
-        template = 'solid',
-        outDir = process.cwd(),
-        installDeps = true,
-    } = options;
-
-    if (!name || !/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name)) {
-        console.error('Error: app name must start with a letter and contain only letters, digits, hyphens or underscores.');
-        process.exit(1);
-    }
-
-    const appDir = path.join(outDir, name);
-    if (fs.existsSync(appDir)) {
-        console.error(`Error: directory "${appDir}" already exists.`);
-        process.exit(1);
-    }
-
-    const cliDir = path.resolve(__dirname, '..');
-    const templateDir = path.join(cliDir, 'templates', template);
-    if (!fs.existsSync(templateDir)) {
-        console.error(`Error: template "${template}" not found in ${path.join(cliDir, 'templates')}`);
-        process.exit(1);
-    }
-
-    const rootDir = findRootDir(outDir);
-
-    // cmake target name: replace hyphens with underscores
-    const cmakeTarget = name.replace(/-/g, '_');
-    const appTitle = name
-        .split(/[-_]/)
-        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-        .join(' ');
-
-    const tokens = {
-        '{{APP_NAME}}': name,
-        '{{APP_TITLE}}': appTitle,
-        '{{CMAKE_TARGET}}': cmakeTarget,
-        '{{REPO_ROOT}}': rootDir.replace(/\\/g, '/'),
-    };
-
-    console.log(`\n=== WindowPP Create — ${name} (template: ${template}) ===\n`);
-    console.log(`Scaffolding into: ${appDir}\n`);
-
-    // ── Copy template ─────────────────────────────────────────────────────────
-    copyDir(templateDir, appDir, tokens);
-
-    // ── Register in CMakeLists.txt ────────────────────────────────────────────
-    const appDirRelative = path.relative(rootDir, appDir).replace(/\\/g, '/');
-    addToCMake(rootDir, name, cmakeTarget, appDirRelative);
-
-    // ── Install frontend deps ─────────────────────────────────────────────────
-    const frontendDir = path.join(appDir, 'frontend');
-    if (installDeps && fs.existsSync(frontendDir)) {
-        console.log('Installing frontend dependencies...');
-        execSync('npm install', { cwd: frontendDir, stdio: 'inherit' });
-    }
-
-    console.log(`\n✓ Created "${name}"\n`);
-    console.log('Next steps:');
-    console.log(`  cd ${name}`);
-    console.log('  windowpp dev\n');
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function copyDir(src, dest, tokens) {
-    fs.mkdirSync(dest, { recursive: true });
-    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-        const srcPath = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
-        if (entry.isDirectory()) {
-            copyDir(srcPath, destPath, tokens);
-        } else {
-            copyFile(srcPath, destPath, tokens);
-        }
-    }
-}
-
-const TEXT_EXTENSIONS = new Set([
-    '.cpp', '.h', '.ts', '.tsx', '.js', '.json', '.html',
-    '.css', '.md', '.txt', '.cmake', '.sh', '.env',
-]);
-
-function copyFile(src, dest, tokens) {
-    const ext = path.extname(src).toLowerCase();
-    if (TEXT_EXTENSIONS.has(ext)) {
-        let content = fs.readFileSync(src, 'utf8');
-        for (const [token, value] of Object.entries(tokens)) {
-            content = content.split(token).join(value);
-        }
-        fs.writeFileSync(dest, content, 'utf8');
-    } else {
-        fs.copyFileSync(src, dest);
-    }
-}
-
-function addToCMake(rootDir, appName, cmakeTarget, appDirRelative) {
-    const cmakePath = path.join(rootDir, 'CMakeLists.txt');
-    let cmake = fs.readFileSync(cmakePath, 'utf8');
-
-    // Insert before the # ─── Install section
-    const installMarker = '# ─── Install ──';
-    if (!cmake.includes(installMarker)) {
-        console.warn('Warning: could not locate Install section in CMakeLists.txt — skipping auto-registration.');
-        return;
-    }
-
-    const appBlock = generateCMakeBlock(appName, cmakeTarget, appDirRelative);
-    cmake = cmake.replace(installMarker, appBlock + '\n' + installMarker);
-    fs.writeFileSync(cmakePath, cmake, 'utf8');
-    console.log(`Registered ${cmakeTarget} in CMakeLists.txt`);
-}
-
-function generateCMakeBlock(appName, cmakeTarget, appDirRelative) {
-    const generatedVar = cmakeTarget.toUpperCase() + '_GENERATED_DIR';
-    const embeddedCppVar = cmakeTarget.toUpperCase() + '_EMBEDDED_ASSETS_CPP';
-    const embeddedHVar = cmakeTarget.toUpperCase() + '_EMBEDDED_ASSETS_H';
-    const assetsTarget = cmakeTarget + '_frontend_assets';
-
-    return `# ─── ${appName} ──────────────────────────────────────────────────────────────────
-
-if(WPP_BUILD_EXAMPLES)
-    add_executable(${cmakeTarget} ${appDirRelative}/main.cpp)
-    target_link_libraries(${cmakeTarget} PRIVATE windowpp nlohmann_json::nlohmann_json)
-    if(WIN32 AND WEBVIEW2_INCLUDE_DIR)
-        target_include_directories(${cmakeTarget} PRIVATE \${WEBVIEW2_INCLUDE_DIR})
-        if(WEBVIEW2_STATIC)
-            target_link_libraries(${cmakeTarget} PRIVATE
-                \${CMAKE_CURRENT_SOURCE_DIR}/src/renderer/webview/x64/WebView2LoaderStatic.lib
-                version)
-        else()
-            target_link_libraries(${cmakeTarget} PRIVATE
-                \${CMAKE_CURRENT_SOURCE_DIR}/src/renderer/webview/x64/WebView2Loader.lib)
-        endif()
-    endif()
-
-    set(${generatedVar}        \${CMAKE_BINARY_DIR}/generated_${cmakeTarget})
-    set(${embeddedCppVar}  \${${generatedVar}}/embedded_assets.cpp)
-    set(${embeddedHVar}    \${${generatedVar}}/embedded_assets.h)
-
-    add_custom_command(
-        OUTPUT  \${${embeddedCppVar}} \${${embeddedHVar}}
-        COMMAND \${CMAKE_COMMAND} -E make_directory \${${generatedVar}}
-        COMMAND \${Python3_EXECUTABLE}
-                \${WPP_EMBED_SCRIPT}
-                \${CMAKE_CURRENT_SOURCE_DIR}/${appDirRelative}/frontend/dist
-                \${${embeddedCppVar}}
-                \${${embeddedHVar}}
-        DEPENDS \${CMAKE_CURRENT_SOURCE_DIR}/${appDirRelative}/frontend/dist/index.html
-        COMMENT "Embedding ${appName} frontend assets into C++ byte arrays..."
-        VERBATIM
-    )
-
-    set_source_files_properties(
-        \${${embeddedCppVar}}
-        \${${embeddedHVar}}
-        PROPERTIES GENERATED TRUE
-    )
-
-    add_custom_target(${assetsTarget} ALL
-        DEPENDS \${${embeddedCppVar}} \${${embeddedHVar}}
-    )
-
-    target_sources(${cmakeTarget} PRIVATE \${${embeddedCppVar}})
-    target_include_directories(${cmakeTarget} PRIVATE \${${generatedVar}})
-    target_compile_definitions(${cmakeTarget} PRIVATE WPP_EMBEDDED_ASSETS)
-    add_dependencies(${cmakeTarget} ${assetsTarget})
-endif()
-
-`;
-}
-
-module.exports = { create };
+#!/usr/bin/env node
+// cli/lib/create.js — WindowPP app scaffolding
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+
+const TEXT_EXTENSIONS = new Set([
+    '.cpp', '.h', '.ts', '.tsx', '.js', '.json', '.html',
+    '.css', '.md', '.txt', '.cmake', '.sh', '.env',
+]);
+
+function copyFile(src, dest, tokens) {
+    const ext = path.extname(src).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext)) {
+        let content = fs.readFileSync(src, 'utf8');
+        for (const [token, value] of Object.entries(tokens)) {
+            content = content.split(token).join(value);
+        }
+        fs.writeFileSync(dest, content, 'utf8');
+    } else {
+        fs.copyFileSync(src, dest);
+    }
+}
+
+function copyDir(src, dest, tokens) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath  = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath, tokens);
+        } else {
+            copyFile(srcPath, destPath, tokens);
+        }
+    }
+}
+
+function create(name, options = {}) {
+    const {
+        template    = 'solid',
+        outDir      = process.cwd(),
+        installDeps = true,
+    } = options;
+
+    if (!name || !/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name)) {
+        console.error('Error: app name must start with a letter and contain only letters, digits, hyphens or underscores.');
+        process.exit(1);
+    }
+
+    const appDir = path.join(outDir, name);
+    if (fs.existsSync(appDir)) {
+        console.error(`Error: directory "${appDir}" already exists.`);
+        process.exit(1);
+    }
+
+    const cliDir      = path.resolve(__dirname, '..');
+    const templateDir = path.join(cliDir, 'templates', template);
+    if (!fs.existsSync(templateDir)) {
+        console.error(`Error: template "${template}" not found in ${path.join(cliDir, 'templates')}`);
+        process.exit(1);
+    }
+
+    const cmakeTarget = name.replace(/-/g, '_');
+    const appTitle = name
+        .split(/[-_]/)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+
+    const tokens = {
+        '{{APP_NAME}}':     name,
+        '{{APP_TITLE}}':    appTitle,
+        '{{CMAKE_TARGET}}': cmakeTarget,
+        // Resolved at create-time so vite.config / API.ts can import from the
+        // installed framework's src/ tree via the @wpp alias.
+        '{{REPO_ROOT}}': path.join(cliDir, 'framework').replace(/\\/g, '/'),
+    };
+
+    console.log(`\n=== WindowPP Create --- ${name} (template: ${template}) ===\n`);
+    console.log(`Scaffolding into: ${appDir}\n`);
+
+    copyDir(templateDir, appDir, tokens);
+
+    const frontendDir = path.join(appDir, 'frontend');
+    if (installDeps && fs.existsSync(frontendDir)) {
+        console.log('Installing frontend dependencies...');
+        execSync('npm install', { cwd: frontendDir, stdio: 'inherit' });
+    }
+
+    console.log(`\n-- Created "${name}"\n`);
+    console.log('Next steps:');
+    console.log(`  cd ${name}`);
+    console.log('  windowpp dev\n');
+}
+
+module.exports = { create };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "windowpp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "WindowPP CLI — build, dev, and scaffold for WindowPP apps",
   "type": "commonjs",
   "bin": {
@@ -16,7 +16,9 @@
   ],
   "scripts": {
     "sync": "node scripts/sync-framework.js",
-    "prepublishOnly": "node scripts/sync-framework.js"
+    "sync:templates": "node scripts/sync-templates.js",
+    "sync:all": "node scripts/sync-framework.js && node scripts/sync-templates.js",
+    "prepublishOnly": "node scripts/sync-framework.js && node scripts/sync-templates.js"
   },
   "engines": {
     "node": ">=18"

package/scripts/publish.js

@@ -47,6 +47,10 @@ console.log(`\n=== windowpp publish: ${pkg.version} → ${nextVersion} (${bumpTy
 console.log('Syncing framework source...');
 execSync('node scripts/sync-framework.js', { cwd: CLI_DIR, stdio: 'inherit' });
 
+// ── Sync templates from monorepo apps ────────────────────────────────────────
+console.log('\nSyncing templates...');
+execSync('node scripts/sync-templates.js', { cwd: CLI_DIR, stdio: 'inherit' });
+
 // ── Publish with the new version (without writing it yet) ─────────────────────
 // Temporarily write the new version so npm publish picks it up, then revert on failure.
 pkg.version = nextVersion;

package/scripts/sync-templates.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+// cli/scripts/sync-templates.js
+//
+// Syncs app directories from the monorepo into cli/templates/ as reusable
+// project templates.  Called manually or as part of the publish flow.
+//
+// Usage:
+//   node cli/scripts/sync-templates.js            — sync all templates
+//   node cli/scripts/sync-templates.js example    — sync one by name
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+const SCRIPT_DIR    = __dirname;
+const CLI_DIR       = path.join(SCRIPT_DIR, '..');
+const REPO_ROOT     = path.join(CLI_DIR, '..');
+const TEMPLATES_DIR = path.join(CLI_DIR, 'templates');
+const BASE_TEMPLATE = path.join(TEMPLATES_DIR, 'solid');
+
+// ─── Template source configuration ───────────────────────────────────────────
+//
+// Each entry describes one template that can be used with `windowpp create`.
+// To register a new app as a template, add an entry here and run this script.
+//
+// Fields:
+//   name         — template dir name  → cli/templates/<name>/
+//   source       — source dir relative to repo root
+//   appName      — concrete npm package name in source  (replaced → {{APP_NAME}})
+//   cmakeTarget  — concrete cmake target in source      (replaced → {{CMAKE_TARGET}})
+//   appTitle     — human-readable title in source       (replaced → {{APP_TITLE}})
+//   useBase      — paths taken from the solid base template instead of source
+//                  (these need standalone-specific content not in the monorepo app)
+//   skip         — relative paths / bare file names to skip when copying from source
+
+const TEMPLATE_SOURCES = [
+    {
+        name:        'example',
+        source:      'example-app',
+        appName:     'windowpp-example',
+        cmakeTarget: 'wpp_example',
+        appTitle:    'WindowPP Example',
+        // Use the standalone-compatible versions from the solid base template
+        useBase: [
+            'CMakeLists.txt',
+            'package.json',
+            'frontend/vite.config.ts',
+        ],
+        // Skip monorepo-specific / generated / lock files
+        skip: [
+            'build.js',
+            'dev.js',
+            'frontend/node_modules',
+            'frontend/dist',
+            'frontend/pnpm-lock.yaml',
+            'frontend/package-lock.json',
+            'frontend/.gitignore',
+            'frontend/README.md',
+        ],
+    },
+    // ── To add more templates, copy an entry like this: ───────────────────────
+    // {
+    //     name:        'icup',
+    //     source:      'ICUP',
+    //     appName:     'wpp-icup',
+    //     cmakeTarget: 'wpp_icup',
+    //     appTitle:    'WindowPP ICUP',
+    //     useBase: ['CMakeLists.txt', 'package.json', 'frontend/vite.config.ts'],
+    //     skip: ['build.js', 'dev.js', 'frontend/node_modules', 'frontend/dist'],
+    // },
+];
+
+// ─── File extensions that get text/token substitution ────────────────────────
+const TEXT_EXTENSIONS = new Set([
+    '.cpp', '.h', '.ts', '.tsx', '.js', '.json', '.html',
+    '.css', '.md', '.txt', '.cmake', '.sh', '.env',
+]);
+
+// ─── Build the list of [from, to] string substitution pairs for an entry ─────
+//
+// Transforms applied to all text files:
+//
+//  1. Concrete app name / cmake target / title → template tokens
+//
+//  2. TypeScript relative imports from frontend/src/ depth (3 levels up to src/):
+//       '../../../src/Foo'  →  '@wpp/Foo'
+//     Covered by the vite alias:  '@wpp' → resolve(REPO_ROOT, 'src')
+//
+//  3. TypeScript relative imports from frontend/ depth (2 levels up):
+//       '../../src/Foo'     →  '@wpp/Foo'
+//
+//  4. C++ #include relative back to src/:
+//       "#include "../src/Foo/bar.h"" → "#include "Foo/bar.h""
+//     Works because CMakeLists adds  target_include_directories(...PRIVATE "${WPP_FRAMEWORK_DIR}/src")
+
+function buildTokens(entry) {
+    return [
+        // ── Name tokens (longer strings first to avoid partial matches) ─────
+        [entry.appName,      '{{APP_NAME}}'],
+        [entry.cmakeTarget,  '{{CMAKE_TARGET}}'],
+        [entry.appTitle,     '{{APP_TITLE}}'],
+
+        // ── TypeScript/TSX: monorepo-relative imports from frontend/src/ ────
+        ["'../../../src/",   "'@wpp/"],
+        ['"../../../src/',   '"@wpp/'],
+
+        // ── TypeScript/TSX: from frontend/ level ───────────────────────────
+        ["'../../src/",      "'@wpp/"],
+        ['"../../src/',      '"@wpp/'],
+
+        // ── C++ includes: "../src/SubDir/file.h" → "SubDir/file.h" ─────────
+        // (CMakeLists adds ${WPP_FRAMEWORK_DIR}/src as a private include dir)
+        ['"../src/',         '"'],
+    ];
+}
+
+function applyTokens(content, tokens) {
+    for (const [from, to] of tokens) {
+        content = content.split(from).join(to);
+    }
+    return content;
+}
+
+// ─── File copy helpers ───────────────────────────────────────────────────────
+function copyFileTransformed(src, dest, tokens) {
+    const ext = path.extname(src).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext)) {
+        let content = fs.readFileSync(src, 'utf8');
+        content = applyTokens(content, tokens);
+        fs.writeFileSync(dest, content, 'utf8');
+    } else {
+        fs.copyFileSync(src, dest);
+    }
+}
+
+// Copy a directory recursively, respecting a per-directory skip set.
+// relPath tracks the path relative to the template root for skip matching.
+function copySourceDir(src, dest, tokens, skipRelPaths, relPrefix) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const dirent of fs.readdirSync(src, { withFileTypes: true })) {
+        const relPath = relPrefix ? `${relPrefix}/${dirent.name}` : dirent.name;
+        // Skip if matched by bare name OR by relative path
+        if (skipRelPaths.has(dirent.name) || skipRelPaths.has(relPath)) continue;
+
+        const srcPath  = path.join(src, dirent.name);
+        const destPath = path.join(dest, dirent.name);
+
+        if (dirent.isDirectory()) {
+            copySourceDir(srcPath, destPath, tokens, skipRelPaths, relPath);
+        } else {
+            copyFileTransformed(srcPath, destPath, tokens);
+        }
+    }
+}
+
+// ─── Sync a single template entry ────────────────────────────────────────────
+function syncTemplate(entry) {
+    const srcDir  = path.join(REPO_ROOT, entry.source);
+    const destDir = path.join(TEMPLATES_DIR, entry.name);
+
+    if (!fs.existsSync(srcDir)) {
+        console.warn(`  ⚠  source not found: ${entry.source} — skipping`);
+        return 0;
+    }
+
+    // Clear and recreate the destination template directory
+    if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+    }
+    fs.mkdirSync(destDir, { recursive: true });
+
+    const tokens      = buildTokens(entry);
+    const useBaseSet  = new Set(entry.useBase  ?? []);
+    const skipRelPaths = new Set(entry.skip ?? []);
+
+    // Also skip the "useBase" paths when copying from source
+    for (const rel of useBaseSet) skipRelPaths.add(rel);
+
+    let count = 0;
+
+    // 1. Overlay "base" files from cli/templates/solid/ (with this entry's tokens)
+    for (const rel of useBaseSet) {
+        const baseSrc  = path.join(BASE_TEMPLATE, rel);
+        const baseDest = path.join(destDir, rel);
+        if (!fs.existsSync(baseSrc)) {
+            console.warn(`    ⚠  base file not found: ${rel}`);
+            continue;
+        }
+        fs.mkdirSync(path.dirname(baseDest), { recursive: true });
+        copyFileTransformed(baseSrc, baseDest, tokens);
+        count++;
+    }
+
+    // 2. Copy everything else from the source app
+    copySourceDir(srcDir, destDir, tokens, skipRelPaths, '');
+
+    // Count total destination files
+    count = countFiles(destDir);
+    return count;
+}
+
+function countFiles(dir) {
+    let n = 0;
+    for (const dirent of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (dirent.isDirectory()) n += countFiles(path.join(dir, dirent.name));
+        else n++;
+    }
+    return n;
+}
+
+// ─── Entry point ─────────────────────────────────────────────────────────────
+function run() {
+    const filter  = process.argv[2];   // optional: name of one template to sync
+    const targets = filter
+        ? TEMPLATE_SOURCES.filter(e => e.name === filter)
+        : TEMPLATE_SOURCES;
+
+    if (filter && targets.length === 0) {
+        const names = TEMPLATE_SOURCES.map(e => e.name).join(', ');
+        console.error(`\nNo template named "${filter}". Available: ${names || '(none)'}\n`);
+        process.exit(1);
+    }
+
+    console.log('\n=== windowpp: syncing templates ===\n');
+
+    let total = 0;
+    for (const entry of targets) {
+        process.stdout.write(`  ${entry.source}  →  templates/${entry.name}/  ...`);
+        const n = syncTemplate(entry);
+        process.stdout.write(`  ${n} file(s)\n`);
+        total += n;
+    }
+
+    console.log(`\n✓ Synced ${targets.length} template(s) (${total} total files)\n`);
+}
+
+run();