feat: add npm template support

[Huxpro]

Add support for using npm packages as templates when creating new projects. This feature allows users to specify custom templates from npm registry with optional version control.

Key Features

• ✅ Support multiple npm template formats (npm:, @scope/package, package-name)
• ✅ Add --template-version flag for version specification
• ✅ Implement smart caching mechanism (.temp-templates/)
• ✅ Support flexible template structures (template/, templates/app/, root)
• ✅ Isolated installation to prevent workspace conflicts
• ✅ Export utility functions for downstream projects

Usage Examples

# Using npm package name
npm create rsbuild@latest my-project -- --template my-template-package

# Using scoped package
npm create rsbuild@latest my-project -- --template @scope/template-package

# Using explicit npm: prefix
npm create rsbuild@latest my-project -- --template npm:my-template-package

# With specific version
npm create rsbuild@latest my-project -- --template my-template-package --template-version 1.2.3

Implementation Details

Template Package Structure

The npm template package should have one of the following structures:

my-template-package/
├── template/              # Preferred
│   ├── package.json
│   └── src/
├── templates/
│   └── app/              # Alternative
└── (root)                # Fallback
    ├── package.json
    └── src/

Caching Strategy

• Templates with latest version are always re-installed to ensure the latest version
• Specific versions are cached in .temp-templates/ for faster reuse

API Exports

import {
  isNpmTemplate,
  resolveCustomTemplate,
  resolveNpmTemplate,
  sanitizeCacheKey,
} from 'create-rstack';

// Check if template input is an npm package
if (isNpmTemplate(templateInput)) {
  // Resolve npm template to local path
  const templatePath = resolveCustomTemplate(templateInput, version);
}

Testing

This feature has been successfully integrated and tested in:

• lynx-stack PR #2406 - create-rspeedy implementation

Related

Inspired by sparkling's npm template implementation.

Checklist

• Code follows project style guidelines
• Documentation updated (README.md)
• No breaking changes
• Tested in downstream project (create-rspeedy)

[chenjiahan]

It looks like #117 was removed from this branch 😂