@ramathibodi/nuxt-commons 0.1.73 → 4.0.0

package/scripts/generate-composables-md.mjs

@@ -0,0 +1,129 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+const rootDir = process.cwd()
+const aiSummaryPath = path.join(rootDir, 'docs/ai-summary.json')
+const outDir = path.join(rootDir, 'docs/composables-md')
+
+if (!fs.existsSync(aiSummaryPath)) {
+  console.error('docs/ai-summary.json not found. Run: npm run docs:ai:summary')
+  process.exit(1)
+}
+
+const ai = JSON.parse(fs.readFileSync(aiSummaryPath, 'utf8'))
+const composables = ai.composables || []
+
+function safeName(filePath) {
+  return filePath
+    .replace(/^src\/runtime\/composables\//, '')
+    .replace(/\//g, '__')
+    .replace(/\.ts$/, '')
+}
+
+function mdEscape(str) {
+  return String(str ?? '').replace(/\|/g, '\\|')
+}
+
+fs.mkdirSync(outDir, { recursive: true })
+
+const index = []
+index.push('# Composables (Markdown)')
+index.push('')
+index.push(`Generated at: ${ai.generatedAt}`)
+index.push('')
+index.push('| Composable | Source |')
+index.push('| ---------- | ------ |')
+
+for (const c of composables) {
+  const fileBase = safeName(c.path)
+  const outFile = path.join(outDir, `${fileBase}.md`)
+  const content = []
+
+  content.push(`# ${fileBase}`)
+  content.push('')
+  content.push(`- Source: \`${c.path}\``)
+  content.push(`- Summary: ${c.summary || ''}`)
+  content.push('')
+
+  const exp = c.exports || {}
+  const functions = exp.functions || []
+  const interfaces = exp.interfaces || []
+  const types = exp.types || []
+  const consts = exp.constants || []
+  const enums = exp.enums || []
+
+  content.push('## Exported Functions')
+  content.push('')
+  if (functions.length) {
+    content.push('| Name | Signature | Returns |')
+    content.push('| ---- | --------- | ------- |')
+    for (const fn of functions) {
+      content.push(`| \`${mdEscape(fn.name)}\` | \`${mdEscape(fn.signature || '')}\` | \`${mdEscape(fn.returns || '')}\` |`)
+    }
+  } else {
+    content.push('No exported functions.')
+  }
+  content.push('')
+
+  content.push('## Exported Interfaces')
+  content.push('')
+  if (interfaces.length) {
+    for (const i of interfaces) {
+      content.push(`### \`${i.name}\``)
+      content.push('')
+      content.push('```ts')
+      content.push(i.shape || '')
+      content.push('```')
+      content.push('')
+    }
+  } else {
+    content.push('No exported interfaces.')
+    content.push('')
+  }
+
+  content.push('## Exported Types')
+  content.push('')
+  if (types.length) {
+    content.push('| Name | Definition |')
+    content.push('| ---- | ---------- |')
+    for (const t of types) {
+      content.push(`| \`${mdEscape(t.name)}\` | \`${mdEscape(t.definition || '')}\` |`)
+    }
+  } else {
+    content.push('No exported types.')
+  }
+  content.push('')
+
+  content.push('## Exported Constants')
+  content.push('')
+  if (consts.length) {
+    content.push('| Name | Type |')
+    content.push('| ---- | ---- |')
+    for (const k of consts) {
+      content.push(`| \`${mdEscape(k.name)}\` | \`${mdEscape(k.type || '')}\` |`)
+    }
+  } else {
+    content.push('No exported constants.')
+  }
+  content.push('')
+
+  content.push('## Exported Enums')
+  content.push('')
+  if (enums.length) {
+    for (const e of enums) {
+      content.push(`### \`${e.name}\``)
+      content.push('')
+      for (const m of e.members || []) content.push(`- \`${m}\``)
+      content.push('')
+    }
+  } else {
+    content.push('No exported enums.')
+    content.push('')
+  }
+
+  fs.writeFileSync(outFile, content.join('\n'))
+  index.push(`| [\`${fileBase}\`](${fileBase}.md) | \`${c.path}\` |`)
+}
+
+fs.writeFileSync(path.join(outDir, 'README.md'), index.join('\n'))
+console.log(`Generated markdown docs for ${composables.length} composables at docs/composables-md`)

package/scripts/release-version.mjs

@@ -0,0 +1,68 @@
+export function parseSemver(version) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version)
+
+  if (!match) {
+    throw new Error(`Invalid semver version: ${version}`)
+  }
+
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    version: `${match[1]}.${match[2]}.${match[3]}`,
+  }
+}
+
+export function getReleaseLine(version) {
+  const parsed = typeof version === 'string' ? parseSemver(version) : version
+  return `${parsed.major}.${parsed.minor}`
+}
+
+export function compareSemver(leftVersion, rightVersion) {
+  const left = typeof leftVersion === 'string' ? parseSemver(leftVersion) : leftVersion
+  const right = typeof rightVersion === 'string' ? parseSemver(rightVersion) : rightVersion
+
+  if (left.major !== right.major) {
+    return left.major - right.major
+  }
+
+  if (left.minor !== right.minor) {
+    return left.minor - right.minor
+  }
+
+  return left.patch - right.patch
+}
+
+export function findLatestVersionInReleaseLine(packageVersion, versions) {
+  const desired = typeof packageVersion === 'string' ? parseSemver(packageVersion) : packageVersion
+  const desiredLine = getReleaseLine(desired)
+
+  return versions
+    .map(version => parseSemver(version))
+    .filter(version => getReleaseLine(version) === desiredLine)
+    .sort((left, right) => compareSemver(right, left))[0]?.version ?? null
+}
+
+export function resolveReleasePlan(packageVersion, latestTagVersion) {
+  const desired = parseSemver(packageVersion)
+  const latest = latestTagVersion ? parseSemver(latestTagVersion) : null
+
+  if (!latest) {
+    return {
+      releaseVersion: desired.version,
+      syncedPackageVersion: desired.version,
+    }
+  }
+
+  if (getReleaseLine(desired) !== getReleaseLine(latest)) {
+    return {
+      releaseVersion: desired.version,
+      syncedPackageVersion: desired.version,
+    }
+  }
+
+  return {
+    releaseVersion: null,
+    syncedPackageVersion: latest.version,
+  }
+}

package/scripts/release.mjs

@@ -0,0 +1,49 @@
+import { execFileSync } from 'node:child_process'
+import { readFileSync, writeFileSync } from 'node:fs'
+
+import { resolveReleasePlan } from './release-version.mjs'
+
+function readPackageJson() {
+  return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+}
+
+function writePackageJson(pkg) {
+  const packageJsonUrl = new URL('../package.json', import.meta.url)
+  writeFileSync(packageJsonUrl, `${JSON.stringify(pkg, null, 2)}\n`)
+}
+
+function getLatestTagVersion() {
+  const output = execFileSync('git', ['tag', '--sort=-v:refname'], {
+    encoding: 'utf8',
+  })
+
+  return output
+    .split('\n')
+    .map(tag => tag.trim())
+    .find(tag => /^v?\d+\.\d+\.\d+(?:[-+].*)?$/.test(tag)) ?? null
+}
+
+function run() {
+  const pkg = readPackageJson()
+  const latestTagVersion = getLatestTagVersion()
+  const plan = resolveReleasePlan(pkg.version, latestTagVersion)
+
+  if (pkg.version !== plan.syncedPackageVersion) {
+    pkg.version = plan.syncedPackageVersion
+    writePackageJson(pkg)
+  }
+
+  const changelogenArgs = ['changelogen', '--release']
+
+  if (plan.releaseVersion) {
+    changelogenArgs.push('-r', plan.releaseVersion)
+  }
+
+  execFileSync('./node_modules/.bin/changelogen', changelogenArgs.slice(1), {
+    stdio: 'inherit',
+  })
+  execFileSync('npm', ['publish'], { stdio: 'inherit' })
+  execFileSync('git', ['push', '--follow-tags'], { stdio: 'inherit' })
+}
+
+run()

package/dist/module.cjs

@@ -1,5 +0,0 @@
-module.exports = function(...args) {
-  return import('./module.mjs').then(m => m.default.call(this, ...args))
-}
-const _meta = module.exports.meta = require('./module.json')
-module.exports.getMeta = () => Promise.resolve(_meta)

package/dist/module.d.ts

@@ -1,8 +0,0 @@
-import * as _nuxt_schema from '@nuxt/schema';
-
-interface ModuleOptions {
-}
-declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
-
-export { _default as default };
-export type { ModuleOptions };

package/dist/types.d.ts

@@ -1,7 +0,0 @@
-import type { NuxtModule } from '@nuxt/schema'
-
-import type { default as Module } from './module'
-
-export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
-
-export { default } from './module'