Merge branch 'main' into feat/convert-npmjs-readme-urls-to-npmx

Author: mikouaji

.github/workflows/ci.yml

@@ -98,3 +98,20 @@ jobs:
         run: ./scripts/lighthouse-a11y.sh
         env:
           LHCI_GITHUB_APP_TOKEN: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
+
+  knip:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - run: corepack enable
+      - uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+          cache: pnpm
+
+      - name: 📦 Install dependencies
+        run: pnpm install
+
+      - name: 🔍 Check for unused code
+        run: pnpm knip:production

app/composables/useCachedFetch.ts

@@ -1,5 +1,3 @@
-import type { H3Event } from 'h3'
-
 /**
  * Type for the cachedFetch function attached to event context.
  */
@@ -32,6 +30,7 @@ export type CachedFetchFunction = <T = unknown>(
  *   )
  * }
  * ```
+ * @public
  */
 export function useCachedFetch(): CachedFetchFunction {
   // On client, return a function that just uses $fetch
@@ -72,28 +71,3 @@ export function useCachedFetch(): CachedFetchFunction {
     return (await $fetch(url, options as Parameters<typeof $fetch>[1])) as T
   }
 }
-
-/**
- * Create a cachedFetch function from an H3Event.
- * Useful when you have direct access to the event.
- */
-export function getCachedFetchFromEvent(event: H3Event | undefined): CachedFetchFunction {
-  const serverCachedFetch = event?.context?.cachedFetch
-
-  if (serverCachedFetch) {
-    return serverCachedFetch as CachedFetchFunction
-  }
-
-  // Fallback to regular $fetch
-  return async <T = unknown>(
-    url: string,
-    options: {
-      method?: string
-      body?: unknown
-      headers?: Record<string, string>
-    } = {},
-    _ttl?: number,
-  ): Promise<T> => {
-    return (await $fetch(url, options as Parameters<typeof $fetch>[1])) as T
-  }
-}

app/composables/useCharts.ts

@@ -286,6 +286,7 @@ function getNpmPackageCreationDate(packument: PackumentLikeForTime): string | nu
   return versionDates[0] ?? null
 }
 
+/** @public */
 export function useCharts() {
   function resolveDateRange(
     downloadEvolutionOptions: PackageDownloadEvolutionOptions,

app/composables/useConnector.ts

@@ -55,6 +55,7 @@ interface StateResponse {
 const STORAGE_KEY = 'npmx-connector'
 const DEFAULT_PORT = 31415
 
+/** @public */
 export const useConnector = createSharedComposable(function useConnector() {
   // Persisted connection config
   const config = useState<{ token: string; port: number } | null>('connector-config', () => null)

app/composables/useFileTreeState.ts

@@ -1,3 +1,4 @@
+/** @public */
 export function useFileTreeState(baseUrl: string) {
   const stateKey = computed(() => `npmx-file-tree${baseUrl}`)
 

app/composables/useInstallCommand.ts

@@ -3,6 +3,7 @@ import type { JsrPackageInfo } from '#shared/types/jsr'
 /**
  * Composable for generating install commands with support for
  * multiple package managers, @types packages, and JSR.
+ * @public
  */
 export function useInstallCommand(
   packageName: MaybeRefOrGetter<string | null>,

app/composables/useNpmRegistry.ts

@@ -108,6 +108,7 @@ function transformPackument(pkg: Packument, requestedVersion?: string | null): S
   }
 }
 
+/** @public */
 export function usePackage(
   name: MaybeRefOrGetter<string>,
   requestedVersion?: MaybeRefOrGetter<string | null>,
@@ -147,6 +148,7 @@ function getResolvedVersion(pkg: SlimPackument, reqVer?: string | null): string
   return resolved
 }
 
+/** @public */
 export function usePackageDownloads(
   name: MaybeRefOrGetter<string>,
   period: MaybeRefOrGetter<'last-day' | 'last-week' | 'last-month' | 'last-year'> = 'last-week',
@@ -174,6 +176,7 @@ type NpmDownloadsRangeResponse = {
 /**
  * Fetch download range data from npm API.
  * Exported for external use (e.g., in components).
+ * @public
  */
 export async function fetchNpmDownloadsRange(
   packageName: string,
@@ -186,48 +189,13 @@ export async function fetchNpmDownloadsRange(
   )
 }
 
-export function usePackageWeeklyDownloadEvolution(
-  name: MaybeRefOrGetter<string>,
-  options: MaybeRefOrGetter<{
-    weeks?: number
-    endDate?: string
-  }> = {},
-) {
-  const cachedFetch = useCachedFetch()
-
-  return useLazyAsyncData(
-    () => `downloads-weekly-evolution:${toValue(name)}:${JSON.stringify(toValue(options))}`,
-    async () => {
-      const packageName = toValue(name)
-      const { weeks = 12, endDate } = toValue(options) ?? {}
-
-      const today = new Date()
-      const yesterday = new Date(
-        Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate() - 1),
-      )
-
-      const end = endDate ? new Date(`${endDate}T00:00:00.000Z`) : yesterday
-
-      const start = addDays(end, -(weeks * 7) + 1)
-      const startIso = toIsoDateString(start)
-      const endIso = toIsoDateString(end)
-
-      const encodedName = encodePackageName(packageName)
-      const range = await cachedFetch<NpmDownloadsRangeResponse>(
-        `${NPM_API}/downloads/range/${startIso}:${endIso}/${encodedName}`,
-      )
-      const sortedDaily = [...range.downloads].sort((a, b) => a.day.localeCompare(b.day))
-      return buildWeeklyEvolutionFromDaily(sortedDaily)
-    },
-  )
-}
-
 const emptySearchResponse = {
   objects: [],
   total: 0,
   time: new Date().toISOString(),
 } satisfies NpmSearchResponse
 
+/** @public */
 export function useNpmSearch(
   query: MaybeRefOrGetter<string>,
   options: MaybeRefOrGetter<{
@@ -305,6 +273,7 @@ function packumentToSearchResult(pkg: MinimalPackument): NpmSearchResult {
 /**
  * Fetch all packages for an npm organization
  * Returns search-result-like objects for compatibility with PackageList
+ * @public
  */
 export function useOrgPackages(orgName: MaybeRefOrGetter<string>) {
   const cachedFetch = useCachedFetch()
@@ -418,35 +387,6 @@ export async function fetchAllPackageVersions(packageName: string): Promise<Pack
   return promise
 }
 
-/**
- * Composable to fetch all versions of a package.
- * Uses SWR caching on the server.
- */
-export function useAllPackageVersions(packageName: MaybeRefOrGetter<string>) {
-  const cachedFetch = useCachedFetch()
-
-  return useLazyAsyncData(
-    () => `all-versions:${toValue(packageName)}`,
-    async () => {
-      const encodedName = encodePackageName(toValue(packageName))
-      const data = await cachedFetch<{
-        versions: Record<string, { deprecated?: string }>
-        time: Record<string, string>
-      }>(`${NPM_REGISTRY}/${encodedName}`)
-
-      return Object.entries(data.versions)
-        .filter(([v]) => data.time[v])
-        .map(([version, versionData]) => ({
-          version,
-          time: data.time[version],
-          hasProvenance: false, // Would need to check dist.attestations for each version
-          deprecated: versionData.deprecated,
-        }))
-        .sort((a, b) => compare(b.version, a.version)) as PackageVersionInfo[]
-    },
-  )
-}
-
 // ============================================================================
 // Outdated Dependencies
 // ============================================================================
@@ -567,6 +507,7 @@ async function checkDependencyOutdated(
 /**
  * Composable to check for outdated dependencies.
  * Returns a reactive map of dependency name to outdated info.
+ * @public
  */
 export function useOutdatedDependencies(
   dependencies: MaybeRefOrGetter<Record<string, string> | undefined>,
@@ -616,6 +557,7 @@ export function useOutdatedDependencies(
 
 /**
  * Get tooltip text for an outdated dependency
+ * @public
  */
 export function getOutdatedTooltip(info: OutdatedDependencyInfo): string {
   if (info.majorsBehind > 0) {
@@ -631,6 +573,7 @@ export function getOutdatedTooltip(info: OutdatedDependencyInfo): string {
 
 /**
  * Get CSS class for a dependency version based on outdated status
+ * @public
  */
 export function getVersionClass(info: OutdatedDependencyInfo | undefined): string {
   if (!info) return 'text-fg-subtle'

app/composables/usePackageAnalysis.ts

@@ -14,6 +14,7 @@ export interface PackageAnalysisResponse {
 
 /**
  * Composable for fetching package analysis data (module format, types info, etc.)
+ * @public
  */
 export function usePackageAnalysis(
   packageName: MaybeRefOrGetter<string>,

app/composables/usePackageRoute.ts

@@ -8,6 +8,7 @@
  *   /@nuxt/kit/v/1.0.0 → packageName: "@nuxt/kit", requestedVersion: "1.0.0"
  *   /axios@1.13.3 → packageName: "axios", requestedVersion: "1.13.3"
  *   /@nuxt/kit@1.0.0 → packageName: "@nuxt/kit", requestedVersion: "1.0.0"
+ * @public
  */
 export function usePackageRoute() {
   const route = useRoute('package')

app/composables/useRepoMeta.ts

@@ -760,6 +760,7 @@ const providers: readonly ProviderAdapter[] = [
 
 const parseRepoFromUrl = parseRepoUrl
 
+/** @public */
 export function useRepoMeta(repositoryUrl: MaybeRefOrGetter<string | null | undefined>) {
   // Get cachedFetch in setup context (outside async handler)
   const cachedFetch = useCachedFetch()