fg-devkit 1.6.8 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fg-devkit",
-  "version": "1.6.8",
+  "version": "1.7.0",
   "description": "Shared configs, scripts, and DX tooling for Vue / TypeScript frontend repos",
   "type": "module",
   "license": "UNLICENSED",
@@ -23,6 +23,7 @@
     "./cz-config": "./scripts/cz/.cz-config.cjs",
     "./scripts/sync-peers-from-dev.mjs": "./scripts/sync-peers-from-dev.mjs",
     "./scripts/sync-vscode-settings.mjs": "./scripts/sync-vscode-settings.mjs",
+    "./scripts/sync-core-coding-standards.mjs": "./scripts/sync-core-coding-standards.mjs",
     "./scripts/sync-tooling-configs.mjs": "./scripts/sync-tooling-configs.mjs",
     "./scripts/sync-project-configs.mjs": "./scripts/sync-project-configs.mjs",
     "./scripts/sync-consumer-scripts.mjs": "./scripts/sync-consumer-scripts.mjs",

package/scaffold/vue/package.json

@@ -34,7 +34,7 @@
     "@tanstack/vue-query-devtools": "6.1.24",
     "@types/node": "22.16.5",
     "@vitejs/plugin-vue": "6.0.6",
-    "fg-devkit": "1.6.8",
+    "fg-devkit": "1.7.0",
     "start-server-and-test": "2.1.3",
     "tailwindcss": "4.2.4",
     "tsx": "4.21.0",

package/scripts/fg-devkit.mjs

@@ -14,6 +14,7 @@
  *   pnpm exec fg-devkit sync-project-configs   (VS Code + tooling sync; overwrites config files)
  *   pnpm exec fg-devkit sync-tooling-configs   (tooling sync only; overwrites config files)
  *   pnpm exec fg-devkit sync-vscode-settings
+ *   pnpm exec fg-devkit sync-core-coding-standards
  *   pnpm exec fg-devkit sync-consumer-scripts
  *   pnpm exec fg-devkit setup-lefthook
  *   pnpm exec fg-devkit prune-consumer-deps [--dry-run]
@@ -417,6 +418,7 @@ const DIRECT_COMMANDS = {
   'sync-project-configs': 'sync-project-configs.mjs',
   'sync-tooling-configs': 'sync-tooling-configs.mjs',
   'sync-vscode-settings': 'sync-vscode-settings.mjs',
+  'sync-core-coding-standards': 'sync-core-coding-standards.mjs',
   'sync-consumer-scripts': 'sync-consumer-scripts.mjs',
   'setup-lefthook': 'setup-lefthook',
   'prune-consumer-deps': 'prune-consumer-deps.mjs',
@@ -444,6 +446,7 @@ Commands:
   sync-project-configs            VS Code + tooling sync (overwrites config files)
   sync-tooling-configs            Tooling sync only (overwrites config files)
   sync-vscode-settings            Copy shared VS Code settings into .vscode/settings.json
+  sync-core-coding-standards      Copy .cursor core coding standards with consumer package name
   sync-consumer-scripts           Enforce standard fgd scripts in consumer package.json
   setup-lefthook                  Setup lefthook and migrate from husky/lint-staged
   prune-consumer-deps [--dry-run] Remove consumer tooling deps bundled by fg-devkit
@@ -528,6 +531,11 @@ const MENU = [
     label: 'PoEditor: Upload translations',
     run: () => runNode('poeditor-upload.mjs'),
   },
+  {
+    key: '12',
+    label: 'Sync .cursor core coding standards',
+    run: () => runNode('sync-core-coding-standards.mjs'),
+  },
 ]
 
 const MAINTAINER_MENU = [

package/scripts/poeditor-upload.mjs

@@ -8,21 +8,37 @@
  */
 
 import fs from 'node:fs'
+import path from 'node:path'
 
 import { getFlagValue, getPoeditorToken, loadPoeditorConfig, parseFlags, resolvePathFromCwd } from './poeditor-common.mjs'
 
-async function uploadFile({ token, projectId, language, updating }) {
-  const params = new URLSearchParams({
-    api_token: token,
-    id: String(projectId),
-    language,
-    updating,
-  })
+function getUploadType(filePath) {
+  const extension = path.extname(filePath).toLowerCase().replace('.', '')
+  if (!extension) {
+    throw new Error(`Cannot determine file type from "${filePath}"`)
+  }
+  if (extension === 'json') {
+    return 'key_value_json'
+  }
+  return extension
+}
+
+async function uploadFile({ token, projectId, language, filePath }) {
+  const fileBuffer = fs.readFileSync(filePath)
+  const fileName = path.basename(filePath)
+  const uploadType = getUploadType(filePath)
+  const form = new FormData()
+  form.append('api_token', token)
+  form.append('id', String(projectId))
+  form.append('updating', 'terms_translations')
+  form.append('language', language)
+  form.append('overwrite', '1')
+  form.append('type', uploadType)
+  form.append('file', new Blob([fileBuffer]), fileName)
 
   const res = await fetch('https://api.poeditor.com/v2/projects/upload', {
     method: 'POST',
-    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-    body: params,
+    body: form,
   })
   if (!res.ok) {
     throw new Error(`PoEditor upload failed (${res.status})`)
@@ -31,6 +47,10 @@ async function uploadFile({ token, projectId, language, updating }) {
   if (data?.response?.status !== 'success') {
     throw new Error(`Upload failed: ${JSON.stringify(data)}`)
   }
+  const translations = data?.result?.translations
+  console.log(
+    `[poeditor-upload] Upload complete for "${language}" (parsed: ${translations?.parsed ?? 0}, updated: ${translations?.updated ?? 0}, added: ${translations?.added ?? 0})`,
+  )
 }
 
 async function main() {
@@ -49,8 +69,7 @@ async function main() {
   if (hasExplicitLanguage || hasExplicitFile) {
     const language = getFlagValue(flags, 'language', cfg.defaultLanguage)
     const filePath = resolvePathFromCwd(getFlagValue(flags, 'file', cfg.uploadFile))
-    const updating = fs.readFileSync(filePath, 'utf8')
-    await uploadFile({ token, projectId, language, updating })
+    await uploadFile({ token, projectId, language, filePath })
     console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
     return
   }
@@ -59,8 +78,7 @@ async function main() {
   if (uploads.length > 0) {
     for (const [language, file] of uploads) {
       const filePath = resolvePathFromCwd(file)
-      const updating = fs.readFileSync(filePath, 'utf8')
-      await uploadFile({ token, projectId, language, updating })
+      await uploadFile({ token, projectId, language, filePath })
       console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
     }
     return
@@ -68,8 +86,7 @@ async function main() {
 
   const language = cfg.defaultLanguage
   const filePath = resolvePathFromCwd(cfg.uploadFile)
-  const updating = fs.readFileSync(filePath, 'utf8')
-  await uploadFile({ token, projectId, language, updating })
+  await uploadFile({ token, projectId, language, filePath })
   console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
 }
 

package/scripts/sync-core-coding-standards.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Syncs .cursor/rules/core-coding-standards.mdc into the consumer repo.
+ * Rewrites frontmatter description to include the consumer package name.
+ *
+ * Usage:
+ *   node node_modules/fg-devkit/scripts/sync-core-coding-standards.mjs
+ *   pnpm exec fg-devkit sync-core-coding-standards
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const projectRoot = process.cwd()
+const scriptDir = path.dirname(fileURLToPath(import.meta.url))
+
+function findFgDevkitPackageRoot() {
+  const candidates = [
+    path.resolve(scriptDir, '..'),
+    path.join(projectRoot, 'node_modules', 'fg-devkit'),
+    path.join(projectRoot, 'node_modules', 'fds-vue-core', 'node_modules', 'fg-devkit'),
+  ]
+  for (const p of candidates) {
+    if (fs.existsSync(path.join(p, 'package.json'))) {
+      return p
+    }
+  }
+  return null
+}
+
+function getConsumerPackageName() {
+  const pkgPath = path.join(projectRoot, 'package.json')
+  if (!fs.existsSync(pkgPath)) {
+    return 'consumer-project'
+  }
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+    if (typeof pkg.name === 'string' && pkg.name.trim() !== '') {
+      return pkg.name.trim()
+    }
+  } catch {
+    // fall through to default
+  }
+  return 'consumer-project'
+}
+
+const fgRoot = findFgDevkitPackageRoot()
+if (!fgRoot) {
+  console.error(
+    '[sync-core-coding-standards] Could not find fg-devkit (install fg-devkit or a package that bundles it, e.g. fds-vue-core).',
+  )
+  process.exit(1)
+}
+
+const sourcePath = path.join(fgRoot, '.cursor', 'rules', 'core-coding-standards.mdc')
+if (!fs.existsSync(sourcePath)) {
+  console.error('[sync-core-coding-standards] Missing source rule in fg-devkit package.')
+  process.exit(1)
+}
+
+const destinationPath = path.join(projectRoot, '.cursor', 'rules', 'core-coding-standards.mdc')
+const packageName = getConsumerPackageName()
+
+try {
+  const content = fs.readFileSync(sourcePath, 'utf8')
+  const updated = content.replace(
+    /^description:\s*.*$/m,
+    `description: Core coding standards for ${packageName}`,
+  )
+  fs.mkdirSync(path.dirname(destinationPath), { recursive: true })
+  fs.writeFileSync(destinationPath, updated, 'utf8')
+  console.log(`[sync-core-coding-standards] Updated ${destinationPath}`)
+} catch (err) {
+  console.error(`[sync-core-coding-standards] ${err.message}`)
+  process.exit(1)
+}