@lexibase/create-rdx 1.1.0 → 1.2.1

package/README.md

@@ -41,6 +41,12 @@ the runtime. Follow the commands printed by the generator.
 
 ## Recovery
 
+In a pnpm workspace, installation uses the workspace's existing dependencies and
+policy. Before installation and runtime preparation, the creator consolidates
+duplicate exact-version approvals for RDX in `minimumReleaseAgeExclude`. Only
+versions already listed are combined; the age threshold, strict mode, unrelated
+package rules, comments and other workspace settings are preserved.
+
 If installation or preparation fails, the command exits with an error and keeps
 the generated files. Fix the reported issue, enter the created folder and retry
 installation/development using the same package manager. Do not rerun creation

package/bin/index.js

@@ -8,6 +8,7 @@ import fs from 'fs-extra'
 import prompts from 'prompts'
 
 import { parseArguments, validateProjectName } from './options.mjs'
+import { normalizePnpmRdxApprovals } from './pnpm-policy.mjs'
 
 function getPackageManager() {
   const userAgent = process.env.npm_config_user_agent || ''
@@ -113,6 +114,16 @@ async function main() {
   })
   await fs.ensureDir(path.join(targetDir, 'public'))
 
+  const configPath = path.join(targetDir, 'rdx.config.ts')
+  const config = await fs.readFile(configPath, 'utf8')
+  await fs.writeFile(
+    configPath,
+    config.replace(
+      'since: new Date().getFullYear(),',
+      `since: ${new Date().getFullYear()},`
+    )
+  )
+
   const gitignoreTemplatePath = path.join(targetDir, 'gitignore.template')
   await fs.move(gitignoreTemplatePath, path.join(targetDir, '.gitignore'), {
     overwrite: true,
@@ -139,7 +150,11 @@ async function main() {
   if (!skipInstall) {
     try {
       console.log(`\nInstalling dependencies with ${packageManager}...\n`)
+      if (packageManager === 'pnpm')
+        await normalizePnpmRdxApprovals(targetDir)
       await run(packageManager, ['install'], targetDir)
+      if (packageManager === 'pnpm')
+        await normalizePnpmRdxApprovals(targetDir)
       const prepareArgs =
         packageManager === 'npm'
           ? ['exec', '--', 'rdx', 'prepare']

package/bin/pnpm-policy.mjs

@@ -0,0 +1,115 @@
+import { randomUUID } from 'node:crypto'
+import { lstat, readFile, rename, rm, writeFile } from 'node:fs/promises'
+import path from 'node:path'
+
+import { isScalar, isSeq, parseDocument } from 'yaml'
+
+const rdxPackages = new Set([
+  '@lexibase/rdx',
+  '@lexibase/rdx-core',
+  '@lexibase/rdx-next',
+  '@lexibase/rdx-types',
+  '@lexibase/rdx-ui',
+  '@lexibase/rdx-versioning',
+  '@lexibase/create-rdx',
+])
+const version =
+  /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[\da-z.-]+)?(?:\+[\da-z.-]+)?$/i
+
+async function workspaceFile(directory) {
+  let current = path.resolve(directory)
+  while (true) {
+    const filename = path.join(current, 'pnpm-workspace.yaml')
+    try {
+      const info = await lstat(filename)
+      if (!info.isFile() || info.isSymbolicLink()) return undefined
+      return filename
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error
+    }
+    const parent = path.dirname(current)
+    if (parent === current) return undefined
+    current = parent
+  }
+}
+
+function exactRule(value) {
+  if (typeof value !== 'string') return undefined
+  const at = value.indexOf('@', 1)
+  if (at < 0 || !rdxPackages.has(value.slice(0, at))) return undefined
+  const versions = value
+    .slice(at + 1)
+    .split('||')
+    .map((item) => item.trim())
+  if (!versions.length || !versions.every((item) => version.test(item)))
+    return undefined
+  return { name: value.slice(0, at), versions }
+}
+
+/** Merge only exact RDX approvals already recorded by the user or pnpm. */
+export async function normalizePnpmRdxApprovals(directory) {
+  const filename = await workspaceFile(directory)
+  if (!filename) return false
+  const original = await readFile(filename, 'utf8')
+  const document = parseDocument(original)
+  if (document.errors.length)
+    throw new Error(`Cannot read ${filename}: ${document.errors[0].message}`)
+  const approvals = document.get('minimumReleaseAgeExclude', true)
+  if (approvals === undefined) return false
+  // Leave aliases and non-literal policy definitions to pnpm itself.
+  if (
+    !isSeq(approvals) ||
+    approvals.items.some(
+      (item) => !isScalar(item) || typeof item.value !== 'string'
+    )
+  )
+    return false
+
+  const groups = new Map()
+  const removed = new Set()
+  for (const node of approvals.items) {
+    const rule = exactRule(node.value)
+    if (!rule) continue
+    const first = groups.get(rule.name)
+    if (!first) {
+      groups.set(rule.name, { node, versions: new Set(rule.versions) })
+      continue
+    }
+    for (const value of rule.versions) first.versions.add(value)
+    first.node.value = `${rule.name}@${[...first.versions].join(' || ')}`
+    // Retain comments attached to approvals that are folded into the first rule.
+    if (node.commentBefore)
+      first.node.commentBefore = [first.node.commentBefore, node.commentBefore]
+        .filter(Boolean)
+        .join('\n')
+    if (node.comment)
+      first.node.comment = [first.node.comment, node.comment]
+        .filter(Boolean)
+        .join('\n')
+    removed.add(node)
+  }
+  if (!removed.size) return false
+  approvals.items = approvals.items.filter((node) => !removed.has(node))
+  let updated = document.toString({ lineWidth: 0 })
+  if (original.includes('\r\n')) updated = updated.replaceAll('\n', '\r\n')
+  const temporary = path.join(
+    path.dirname(filename),
+    `.rdx-policy-${randomUUID()}.tmp`
+  )
+  try {
+    const info = await lstat(filename)
+    await writeFile(temporary, updated, { flag: 'wx', mode: info.mode })
+    if (
+      info.isSymbolicLink() ||
+      (await readFile(filename, 'utf8')) !== original
+    )
+      throw new Error(
+        `The pnpm policy changed during project creation: ${filename}. Retry without concurrent installs.`
+      )
+    await rename(temporary, filename)
+  } finally {
+    await rm(temporary, { force: true })
+  }
+  console.log(`Consolidated existing RDX version approvals in ${filename}.`)
+  return true
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexibase/create-rdx",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Create a new RDX documentation project.",
   "license": "MIT",
   "bin": {
@@ -30,7 +30,8 @@
   "dependencies": {
     "cross-spawn": "^7.0.6",
     "fs-extra": "^11.1.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "yaml": "^2.9.1"
   },
   "scripts": {
     "test": "node --test tests/*.test.mjs"

package/templates/default/package.json

@@ -9,7 +9,7 @@
     "start": "rdx start"
   },
   "dependencies": {
-    "@lexibase/rdx": "1.1.0",
+    "@lexibase/rdx": "1.2.0",
     "next": "^16.4.2",
     "react": "19.3.1",
     "react-dom": "19.3.1"

package/templates/default/rdx.config.ts

@@ -2,10 +2,12 @@ import { defineConfig } from '@lexibase/rdx'
 
 export default defineConfig({
   description: 'Documentation built with RDX.',
-  // SEO and link previews. Paths starting with '/' refer to files in public/.
+  // Site identity, SEO and link previews. '/' paths refer to files in public/.
   metadata: {
     // The single site name: browser titles, social previews and default branding.
     applicationName: 'My documentation',
+    // Footer starting year. Change it to an earlier founding year if needed.
+    since: new Date().getFullYear(),
     // Set metadataBase to your public site URL to resolve relative share images.
     // Optional examples below: uncomment only after adding the referenced files.
     // icons: {