@uselets/ui 0.6.0 → 0.6.1

package/dist/skills/uselets-ui/scripts/print-public-api.mjs

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+function exists(targetPath) {
+  return fs.existsSync(targetPath)
+}
+
+function read(filePath) {
+  return fs.readFileSync(filePath, 'utf8')
+}
+
+function listFiles(dirPath, extension) {
+  return fs
+    .readdirSync(dirPath)
+    .filter((file) => file.endsWith(extension))
+    .sort((left, right) => left.localeCompare(right))
+}
+
+function uniqueSorted(values) {
+  return [...new Set(values)].sort((left, right) => left.localeCompare(right))
+}
+
+function findInstalledPackageJson(startDir) {
+  let currentDir = path.resolve(startDir)
+
+  while (true) {
+    const candidate = path.join(currentDir, 'node_modules/@uselets/ui/package.json')
+
+    if (exists(candidate)) {
+      return candidate
+    }
+
+    const parentDir = path.dirname(currentDir)
+
+    if (parentDir === currentDir) {
+      return null
+    }
+
+    currentDir = parentDir
+  }
+}
+
+function parseNamedPart(part) {
+  const trimmed = part.trim()
+
+  if (!trimmed) {
+    return null
+  }
+
+  const isType = trimmed.startsWith('type ')
+  const withoutType = isType ? trimmed.slice(5).trim() : trimmed
+  const segments = withoutType.split(/\s+as\s+/i)
+  const name = segments[segments.length - 1].trim()
+
+  if (!name) {
+    return null
+  }
+
+  return { isType, name }
+}
+
+function collectExports(source) {
+  const runtime = []
+  const types = []
+
+  for (const match of source.matchAll(/export\s+(const|function|class|declare\s+const|declare\s+function|declare\s+class)\s+([A-Za-z0-9_]+)/g)) {
+    runtime.push(match[2])
+  }
+
+  for (const match of source.matchAll(/export\s+(type|interface)\s+([A-Za-z0-9_]+)/g)) {
+    types.push(match[2])
+  }
+
+  for (const match of source.matchAll(/export\s+(type\s+)?\{([\s\S]*?)\}\s*(?:from\s+['"][^'"]+['"])?/g)) {
+    const blockIsTypeOnly = Boolean(match[1])
+    const parts = match[2].split(',').map((part) => parseNamedPart(part)).filter(Boolean)
+
+    for (const part of parts) {
+      if (blockIsTypeOnly || part.isType) {
+        types.push(part.name)
+      } else {
+        runtime.push(part.name)
+      }
+    }
+  }
+
+  return {
+    runtime: uniqueSorted(runtime),
+    types: uniqueSorted(types)
+  }
+}
+
+function buildModuleList(dirPath, extension, kind, packageRoot) {
+  if (!exists(dirPath)) {
+    return []
+  }
+
+  return listFiles(dirPath, extension).map((fileName) => {
+    const source = read(path.join(dirPath, fileName))
+    const moduleName = fileName.replace(new RegExp(`${extension}$`), '')
+
+    return {
+      kind,
+      module: moduleName,
+      source: path.relative(packageRoot, path.join(dirPath, fileName)),
+      subpath: getPublicSubpath(kind, moduleName),
+      ...collectExports(source)
+    }
+  })
+}
+
+function getPublicSubpath(kind, moduleName) {
+  if (kind === 'hooks') {
+    return `@uselets/ui/hooks/${moduleName}`
+  }
+
+  if (kind === 'lib') {
+    return moduleName === 'utils' ? '@uselets/ui/utils' : `@uselets/ui/lib/${moduleName}`
+  }
+
+  return `@uselets/ui/${moduleName}`
+}
+
+function printModuleSection(title, modules) {
+  console.log(`\n## ${title}\n`)
+
+  for (const moduleInfo of modules) {
+    console.log(`### ${moduleInfo.module}`)
+    console.log(`- source: \`${moduleInfo.source}\``)
+    console.log(`- subpath: \`${moduleInfo.subpath}\``)
+    console.log(`- runtime exports: ${moduleInfo.runtime.length > 0 ? `\`${moduleInfo.runtime.join('`, `')}\`` : '_none_'}`)
+    console.log(`- type exports: ${moduleInfo.types.length > 0 ? `\`${moduleInfo.types.join('`, `')}\`` : '_none_'}`)
+    console.log('')
+  }
+}
+
+const packageJsonPath = findInstalledPackageJson(process.cwd())
+
+if (!packageJsonPath) {
+  console.log('# @uselets/ui public API\n')
+  console.log('No installed `@uselets/ui` package was found from the current working directory.')
+  console.log('Install the package first or use the bundled references in this skill as a snapshot.')
+  process.exit(0)
+}
+
+const packageRoot = path.dirname(packageJsonPath)
+const packageJson = JSON.parse(read(packageJsonPath))
+const distRoot = path.join(packageRoot, 'dist')
+
+const componentModules = buildModuleList(path.join(distRoot, 'components'), '.d.ts', 'components', packageRoot)
+const hookModules = buildModuleList(path.join(distRoot, 'hooks'), '.d.ts', 'hooks', packageRoot)
+const libModules = buildModuleList(path.join(distRoot, 'lib'), '.d.ts', 'lib', packageRoot)
+
+console.log('# @uselets/ui public API\n')
+console.log(`- package root: \`${packageRoot}\``)
+console.log(`- package version: \`${packageJson.version ?? 'unknown'}\``)
+console.log('- barrel: `@uselets/ui`')
+console.log('- component subpaths: `@uselets/ui/*`')
+console.log('- hook subpaths: `@uselets/ui/hooks/*`')
+console.log('- utility helpers: `@uselets/ui/utils`')
+console.log('- styles: `@uselets/ui/styles.css` (legacy Max theme alias)')
+console.log('- Max theme: `@uselets/ui/themes/max.css`')
+console.log('- Gomax theme: `@uselets/ui/themes/gomax.css`')
+console.log('- PostCSS preset: `@uselets/ui/postcss.config`')
+console.log('')
+console.log(`- components: ${componentModules.length}`)
+console.log(`- hooks: ${hookModules.length}`)
+console.log(`- lib modules: ${libModules.length}`)
+
+printModuleSection('Components', componentModules)
+printModuleSection('Hooks', hookModules)
+printModuleSection('Lib', libModules)