valaxy-addon-typedoc 0.1.0 → 0.1.1

package/node/loader.ts

@@ -3,12 +3,12 @@ import type { TypeDocAddonOptions } from './index'
 import { execFileSync, spawn } from 'node:child_process'
 import { createHash } from 'node:crypto'
 import { createRequire } from 'node:module'
-import { dirname, relative, resolve, sep } from 'node:path'
+import { dirname, posix, relative, resolve, sep } from 'node:path'
 import process from 'node:process'
 import { fileURLToPath } from 'node:url'
-import fg from 'fast-glob'
 import fs from 'fs-extra'
 import { minimatch } from 'minimatch'
+import { glob } from 'tinyglobby'
 import { resolveSymbolAnchors } from './links'
 
 interface NavigationItem {
@@ -46,12 +46,12 @@ export function createTypeDocLoader(settings: TypeDocAddonOptions, userRoot: str
   let runs = 0
 
   async function sourceFiles() {
-    const sources = await fg(settings.watch, { cwd: userRoot, absolute: true, onlyFiles: true, ignore: ['**/.valaxy/**', '**/dist/**'] })
+    const sources = await glob(settings.watch, { cwd: userRoot, absolute: true, onlyFiles: true, ignore: ['**/.valaxy/**', '**/dist/**'] })
     return [...new Set([optionsFile, ...sources, ...dependencies])].sort()
   }
 
   async function fingerprint(files: string[]) {
-    const hash = createHash('sha256').update(JSON.stringify({ schema: 8, settings }))
+    const hash = createHash('sha256').update(JSON.stringify({ schema: 9, settings }))
     for (const pkg of ['valaxy-addon-typedoc', 'typedoc', 'typedoc-plugin-markdown', 'typescript']) {
       let directory = dirname(require.resolve(pkg))
       while (directory !== dirname(directory)) {
@@ -66,7 +66,26 @@ export function createTypeDocLoader(settings: TypeDocAddonOptions, userRoot: str
     // Source links generated by TypeDoc point at this exact revision.
     try {
       source.revision = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: userRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
-      source.dirty = !!execFileSync('git', ['status', '--porcelain'], { cwd: userRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
+      const prefix = execFileSync('git', ['rev-parse', '--show-prefix'], { cwd: userRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
+      const roots = [resolve(userRoot), await fs.realpath(userRoot)]
+      const inputs = new Set((await Promise.all(files.map(async (file) => {
+        // Git and Node can spell a Windows temp path with long or 8.3 names.
+        // Resolve from the selected project instead of comparing Git root names.
+        const paths = [file, await fs.realpath(file).catch(() => file)]
+        return roots.flatMap(root => paths.map(path => posix.normalize(`${prefix}${relative(root, path).replaceAll('\\', '/')}`)))
+      }))).flat())
+      const changes = execFileSync('git', ['status', '--porcelain=v1', '-z', '--untracked-files=all'], { cwd: userRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).split('\0')
+      // Generated site metadata and unrelated edits do not change API sources.
+      // NUL-delimited paths preserve spaces and non-ASCII names, including renames.
+      source.dirty = false
+      for (let index = 0; index < changes.length; index++) {
+        const entry = changes[index]
+        source.dirty ||= inputs.has(entry.slice(3))
+        if (/[RC]/.test(entry.slice(0, 2))) {
+          const previousPath = changes[++index]
+          source.dirty ||= inputs.has(previousPath)
+        }
+      }
       hash.update(JSON.stringify({ revision: source.revision, dirty: source.dirty }))
     }
     catch { hash.update('unversioned') }
@@ -138,7 +157,7 @@ export function createTypeDocLoader(settings: TypeDocAddonOptions, userRoot: str
       const result = await fs.readJson(resultFile) as { files: string[], version?: string }
       dependencies = result.files
       source.version = result.version
-      const paths = await fg('**/*.md', { cwd: output })
+      const paths = await glob('**/*.md', { cwd: output })
       if (!paths.length)
         throw new Error('[typedoc] Refusing to publish empty API documentation.')
       const sources = new Map(await Promise.all(paths.map(async page => [page, await fs.readFile(resolve(output, page), 'utf8')] as const)))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "valaxy-addon-typedoc",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Cached TypeDoc reference pages for Valaxy documentation sites",
   "license": "MIT",
   "repository": {
@@ -27,15 +27,15 @@
     "valaxy": ">=1.0.0-rc.13 <2"
   },
   "dependencies": {
-    "fast-glob": "^3.3.3",
     "fs-extra": "^11.4.0",
     "minimatch": "^10.2.4",
+    "tinyglobby": "^0.2.17",
     "typedoc": "^0.28.20",
     "typedoc-plugin-markdown": "^4.13.1",
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "valaxy": "1.0.0-rc.15"
+    "valaxy": "1.0.0"
   },
   "publishConfig": {
     "access": "public"