Bump version

Author: koculu

docs/template-scaffolding.md

@@ -18,7 +18,7 @@ template-defined categories, configuration bindings, and extension points.
 - Git initialization is opt-in with `--git`; never create an initial commit.
 - Accept explicit npm package versions and local `.tgz` files or package folders.
 - Require an absent or empty destination. Stage and validate before writing.
-- Check compatibility against the running CLI and pin that exact PureStack version.
+- Check template compatibility against the running CLI. Keep the template's dependency selectors; the starter uses `latest` for PureStack packages.
 - Preserve generated files if installation or Git initialization fails, with retry
   instructions and a failing exit status.
 
@@ -44,12 +44,14 @@ project, including `package.json`, `README.md`, `AGENTS.md`, and
 Project dependencies must use registry versions, ranges, tags, or `npm:` aliases.
 Workspace references, local paths, Git sources, and tarball URLs are rejected.
 
-The generated package name, `purestack` dependency, site title, and logo brand
+The generated package name, site title, and logo brand
 are customized. Template-defined option bindings can configure appearance,
 features, publishing, and plugin settings. Unspecified values use the template's
-declared defaults. The `purestack` dependency uses the literal
-`{{purestackVersion}}` in the source template. Other `@purestack/*` dependencies
-can use the same token to share the CLI's product version, including test helpers.
+declared defaults. The starter declares `purestack` and its `@purestack/*`
+dependencies as `latest`. The package manager resolves their current published
+releases during installation and records the exact versions in the project's
+lockfile. The CLI preserves template dependency selectors instead of pinning them
+to its own version. Templates can also declare published versions, ranges, and tags.
 Keep `.gitignore` and `.yarnrc.yml` under their real names and explicitly include
 `template/.gitignore` and `template/.yarnrc.yml` in the package's `files` list.
 `yarn package` and `yarn publish-package` use npm to pack templates, preserving

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "purestack-repo",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "packageManager": "yarn@4.18.1",
   "type": "module",
   "sideEffects": false,

packages/purestack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purestack",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/purestack.mjs",
   "types": "./dist/purestack.d.mts",

packages/purestack/src/cli/terminal/creation-view.ts

@@ -60,7 +60,7 @@ export class CreationView {
   start(title: string, directory: string, version: string) {
     return `\n${this.frame(
       '◈ PURESTACK · CREATE SITE',
-      [title, '', `Directory  ${directory}`, `PureStack  ${version}`],
+      [title, '', `Directory  ${directory}`, `PureStack CLI  ${version}`],
       'accent',
     )}\n\n`
   }
@@ -101,7 +101,7 @@ export class CreationView {
       [
         `Directory  ${result.directory}`,
         `Template   ${result.template}`,
-        `PureStack  ${result.version}`,
+        `PureStack CLI  ${result.version}`,
       ],
       tone,
     )

packages/purestack/src/index.ts

@@ -1,3 +1,3 @@
-export const version: string = '1.1.19'
+export const version: string = '1.1.20'
 
 export * from '@purestack/ts-ssg'

packages/purestack/src/init/init.test.ts

@@ -203,21 +203,21 @@ describe('project generation', () => {
     expect(project).toMatchObject({
       name: 'my-docs',
       private: true,
-      dependencies: { purestack: cliVersion },
+      dependencies: { purestack: 'latest' },
     })
     expect(prepared.packageManager).toBe('yarn')
     expect(await readFile(path.join(destination, 'yarn.lock'), 'utf8')).toBe('')
     expect(project.packageManager).toBe('yarn@4.18.1')
-    expect(project.devDependencies['@purestack/ts-minidom']).toBe(cliVersion)
+    expect(project.devDependencies['@purestack/ts-minidom']).toBe('latest')
     const yarnConfig = await readFile(
       path.join(destination, '.yarnrc.yml'),
       'utf8',
     )
     expect(yarnConfig).toContain('nodeLinker: node-modules')
     expect(yarnConfig).toContain('npmMinimalAgeGate: 0')
     expect(project.dependencies).toMatchObject({
-      '@purestack/ts-style': cliVersion,
-      regor: '^1.7.6',
+      '@purestack/ts-style': 'latest',
+      regor: 'latest',
     })
     expect(
       JSON.parse(
@@ -241,6 +241,36 @@ describe('project generation', () => {
     ).toContain('yarn build')
   })
 
+  it('preserves template dependency selectors instead of replacing them with the CLI version', async () => {
+    const unpacked = await fixture()
+    const packageFile = path.join(unpacked, 'template/package.json')
+    const project = JSON.parse(await readFile(packageFile, 'utf8'))
+    project.dependencies.purestack = '1.2.3'
+    project.dependencies['@purestack/ts-style'] = '^1.2.0'
+    await writeFile(packageFile, JSON.stringify(project))
+
+    await prepareProject(unpacked, path.join(temporary, 'project'), cliVersion)
+
+    expect(
+      JSON.parse(await readFile(packageFile, 'utf8')).dependencies,
+    ).toEqual(project.dependencies)
+  })
+
+  it.each([undefined, 42])(
+    'rejects a missing or invalid PureStack dependency (%s)',
+    async (dependency) => {
+      const unpacked = await fixture()
+      const packageFile = path.join(unpacked, 'template/package.json')
+      const project = JSON.parse(await readFile(packageFile, 'utf8'))
+      project.dependencies.purestack = dependency
+      await writeFile(packageFile, JSON.stringify(project))
+
+      await expect(
+        prepareProject(unpacked, path.join(temporary, 'project'), cliVersion),
+      ).rejects.toThrow(/must declare dependencies.purestack/)
+    },
+  )
+
   it('rejects incompatible templates without creating a destination', async () => {
     const unpacked = await fixture()
     const destination = path.join(temporary, 'project')
@@ -390,6 +420,7 @@ describe('project generation', () => {
     ' package.tgz ',
     '',
     '{{unknown}}',
+    '{{purestackVersion}}',
   ])('rejects nonportable dependency %s', async (version) => {
     const unpacked = await fixture()
     const packageFile = path.join(unpacked, 'template/package.json')

packages/purestack/src/init/template.ts

@@ -259,10 +259,10 @@ function isRegistryDependency(version: string) {
 export async function prepareProject(
   unpacked: string,
   directory: string,
-  purestackVersion: string,
+  cliVersion: string,
   title = path.basename(directory),
 ) {
-  const { pkg } = await inspectTemplate(unpacked, purestackVersion)
+  const { pkg } = await inspectTemplate(unpacked, cliVersion)
   const source = path.join(unpacked, 'template')
   const files = await listProjectFiles(source)
   for (const file of [
@@ -289,12 +289,9 @@ export async function prepareProject(
     if (match[1] === 'yarn') packageManager = 'yarn'
   }
   const dependencies = project.dependencies
-  if (
-    !isRecord(dependencies) ||
-    dependencies.purestack !== '{{purestackVersion}}'
-  )
+  if (!isRecord(dependencies) || typeof dependencies.purestack !== 'string')
     throw new Error(
-      'Template must declare dependencies.purestack as {{purestackVersion}}.',
+      'Template must declare dependencies.purestack as a published dependency version, range, or tag.',
     )
   for (const field of [
     'dependencies',
@@ -305,21 +302,11 @@ export async function prepareProject(
     const entries = project[field]
     if (entries === undefined) continue
     if (!isRecord(entries)) throw new Error(`Invalid project ${field}.`)
-    for (const [dependency, version] of Object.entries(entries)) {
-      if (
-        typeof version !== 'string' ||
-        (!isRegistryDependency(version) &&
-          !(
-            (dependency === 'purestack' ||
-              dependency.startsWith('@purestack/')) &&
-            version === '{{purestackVersion}}'
-          ))
-      )
+    for (const version of Object.values(entries)) {
+      if (typeof version !== 'string' || !isRegistryDependency(version))
         throw new Error(
           `Project ${field} must use published dependency versions.`,
         )
-      if (version === '{{purestackVersion}}')
-        entries[dependency] = purestackVersion
     }
   }
   const scripts = project.scripts
@@ -345,7 +332,6 @@ export async function prepareProject(
   }
   project.name = projectName(directory)
   project.private = true
-  dependencies.purestack = purestackVersion
   await writeJson(path.join(source, 'package.json'), project)
   const configFile = path.join(source, 'content', 'siteConfig.json')
   const config = await readJson(configFile)

packages/ts-common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purestack/ts-common",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/ts-common.mjs",
   "types": "./dist/ts-common.d.mts",

packages/ts-components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purestack/ts-components",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/ts-components.mjs",
   "types": "./dist/ts-components.d.mts",

packages/ts-css/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purestack/ts-css",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/ts-css.mjs",
   "types": "./dist/ts-css.d.mts",