chore: remove linkcheck-bin which required postinstall scripts

Author: ascott18

docs/.gitignore

@@ -1 +0,0 @@
-!linkcheck-bin-3.0.0-1.fix-issue-56.tgz

docs/.vitepress/components/Prop.vue

@@ -175,7 +175,7 @@ export default defineComponent({
         // - `(` (nongeneric method)
         // - ` {` (prop definition)
         // - `<eol>` (field definition, or prop where {get;set;} were omitted from the def)
-        const result = / (\w+)(?:<|\(| \{|$)/.exec(this.def);
+        const result = / ([\w.]+)(?:<|\(| \{|$)/.exec(this.def);
         this.idAttr = result ? this.idPrefix + "-" + result[1] : null;
       }
 

docs/.vitepress/linkcheck-skip-file.txt

@@ -1,3 +1,5 @@
 github.com/intellitect/coalesce/edit
 github.com/IntelliTect/Coalesce/blob/main
-github.com/IntelliTect/Coalesce/blob/1fb00c7de5e363aaf3c1a78f45af3b949b11dff4/src/coalesce-vue/test/utils.spec.ts#L5
+github.com/IntelliTect/Coalesce/blob/1fb00c7de5e363aaf3c1a78f45af3b949b11dff4/src/coalesce-vue/test/utils.spec.ts#L5
+www.npmjs.com/package/vue-facing-decorator
+www.kalzumeus.com

docs/check-links.mjs

@@ -1,15 +1,112 @@
 import { createServer } from "http";
+import { chmod, mkdir, access, rm, writeFile } from "fs/promises";
+import { spawn } from "child_process";
+import path from "path";
 import handler from "serve-handler";
 import waitOn from "wait-on";
-import { spawn } from "child_process";
 
-function run(command, args, options = {}) {
+const LINKCHECK_VERSION = "3.0.0";
+
+function getLinkcheckPlatformInfo() {
+  const { platform, arch } = process;
+  if (platform === "darwin" && ["x64", "arm64"].includes(arch))
+    return {
+      filename: `linkcheck-${LINKCHECK_VERSION}-macos-${arch}.tar.gz`,
+      bin: "linkcheck/linkcheck",
+    };
+  if (platform === "win32" && arch === "x64")
+    return {
+      filename: `linkcheck-${LINKCHECK_VERSION}-windows-${arch}.zip`,
+      bin: "linkcheck/linkcheck.bat",
+    };
+  if (platform === "linux" && ["x64", "arm64"].includes(arch))
+    return {
+      filename: `linkcheck-${LINKCHECK_VERSION}-linux-${arch}.tar.gz`,
+      bin: "linkcheck/linkcheck",
+    };
+  throw new Error(`Unsupported platform: ${platform} ${arch}`);
+}
+
+async function fileExists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function extractTarGz(buffer, destDir) {
+  const tarball = path.join(destDir, "_archive.tar.gz");
+  await writeFile(tarball, buffer);
+  await runProcess("tar", ["xzf", tarball, "-C", destDir]);
+  await rm(tarball);
+}
+
+async function extractZip(buffer, destDir) {
+  const zipPath = path.join(destDir, "_archive.zip");
+  await writeFile(zipPath, buffer);
+  // Use PowerShell on Windows to extract
+  await runProcess("powershell", [
+    "-NoProfile",
+    "-Command",
+    `Expand-Archive -Path '${zipPath}' -DestinationPath '${destDir}' -Force`,
+  ]);
+  await rm(zipPath);
+}
+
+async function downloadAndVerifyLinkcheck(destDir) {
+  const info = getLinkcheckPlatformInfo();
+  const binPath = path.join(destDir, info.bin);
+
+  if (await fileExists(binPath)) {
+    console.log(`linkcheck already downloaded at ${binPath}`);
+    return binPath;
+  }
+
+  await mkdir(destDir, { recursive: true });
+
+  const releaseUrl = `https://github.com/filiph/linkcheck/releases/download/${LINKCHECK_VERSION}/${info.filename}`;
+
+  console.log(`Downloading linkcheck ${LINKCHECK_VERSION} from ${releaseUrl}`);
+
+  // Download the release
+  const response = await fetch(releaseUrl);
+  if (!response.ok)
+    throw new Error(
+      `Failed to download linkcheck: ${response.status} ${response.statusText}`,
+    );
+  const buffer = Buffer.from(await response.arrayBuffer());
+
+  // Extract
+  if (info.filename.endsWith(".tar.gz")) {
+    await extractTarGz(buffer, destDir);
+  } else if (info.filename.endsWith(".zip")) {
+    await extractZip(buffer, destDir);
+  }
+
+  // Make executable on non-Windows
+  if (process.platform !== "win32") {
+    await chmod(binPath, 0o755);
+  }
+
+  console.log(`linkcheck installed to ${binPath}`);
+  return binPath;
+}
+
+function runProcess(command, args, options = {}) {
   return new Promise((resolve, reject) => {
-    const proc = spawn(command, args, {
-      shell: true,
-      stdio: "inherit",
-      ...options,
-    });
+    // On Windows, .bat files need cmd.exe /c to avoid shell:true deprecation
+    const proc =
+      process.platform === "win32" && command.endsWith(".bat")
+        ? spawn("cmd.exe", ["/c", command, ...args], {
+            stdio: "inherit",
+            ...options,
+          })
+        : spawn(command, args, {
+            stdio: "inherit",
+            ...options,
+          });
     proc.on("close", (code) => {
       code === 0
         ? resolve()
@@ -18,9 +115,18 @@ function run(command, args, options = {}) {
   });
 }
 
+const vendorDir = path.join(
+  path.dirname(new URL(import.meta.url).pathname.replace(/^\/(\w:)/, "$1")),
+  "node_modules",
+  `.linkcheck-${LINKCHECK_VERSION}`,
+);
+
 let server;
 
 try {
+  // Download linkcheck binary if needed
+  const linkcheckBin = await downloadAndVerifyLinkcheck(vendorDir);
+
   // Start static file server
   server = createServer((req, res) =>
     handler(req, res, { public: ".vitepress/dist" }),
@@ -41,7 +147,12 @@ try {
   console.log(`Running linkcheck with skip file: ${skipFile} (CI: ${isCI})`);
 
   // Run linkcheck
-  await run("linkcheck", ["localhost:8087", "-e", "--skip-file", skipFile]);
+  await runProcess(linkcheckBin, [
+    "localhost:8087",
+    "-e",
+    "--skip-file",
+    skipFile,
+  ]);
 
   process.exit(0);
 } catch (err) {

docs/package.json

@@ -17,7 +17,6 @@
   },
   "devDependencies": {
     "gray-matter": "^4.0.3",
-    "linkcheck-bin": "3.0.0-2",
     "serve-handler": "^6.1.6",
     "vitepress": "2.0.0-alpha.12",
     "wait-on": "^8.0.4"

docs/topics/audit-logging.md

@@ -84,7 +84,7 @@ public class OperationContext : DefaultAuditOperationContext<AuditLog>
 
 When you're inheriting from `DefaultAuditLog` for your `IAuditLog` implementation, you'll want to similarly inherit from `DefaultAuditOperationContext<>` for your operation context. It will take care of populating the HTTP request tracking fields on the `AuditLog` record. If you want a totally custom implementation, you only need to implement the `IAuditOperationContext<TAuditLog>` interface.
 
-The operation context class passed to `WithAugmentation` will be injected from the application service provider if available; otherwise, a new instance will be constructed using dependencies from the application service provider. To make an injected dependency optional, make the constructor parameter nullable with a default value of `null`, or create [alternate constructors](https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection#multiple-constructor-discovery-rules).
+The operation context class passed to `WithAugmentation` will be injected from the application service provider if available; otherwise, a new instance will be constructed using dependencies from the application service provider. To make an injected dependency optional, make the constructor parameter nullable with a default value of `null`, or create [alternate constructors](https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection/overview#constructor-selection-rules).
 
 ### 4. Add the UI
 

docs/topics/template-features.md

@@ -61,7 +61,7 @@ Azure OpenAI can be configured in two ways: through .NET Aspire (recommended) or
 
 #### Using .NET Aspire (Recommended)
 
-When launching with the Aspire AppHost, Azure OpenAI will configure and provision cloud resources automatically with [Aspire's local provisioning](https://learn.microsoft.com/en-us/dotnet/aspire/azure/local-provisioning#configuration). Configure the required Azure settings in your AppHost project's `appsettings.json`, `appsettings.localhost.json`, or `dotnet user-secrets`:
+When launching with the Aspire AppHost, Azure OpenAI will configure and provision cloud resources automatically with [Aspire's local provisioning](https://aspire.dev/integrations/cloud/azure/local-provisioning/#configuration). Configure the required Azure settings in your AppHost project's `appsettings.json`, `appsettings.localhost.json`, or `dotnet user-secrets`:
 
 ```json
 {
@@ -74,9 +74,9 @@ When launching with the Aspire AppHost, Azure OpenAI will configure and provisio
 }
 ```
 
-If there's an existing resource you'd rather use instead of provisioning a new resource, see the documentation for [Connecting to an existing Azure OpenAI service](https://learn.microsoft.com/en-us/dotnet/aspire/azureai/azureai-openai-integration?tabs=package-reference#connect-to-an-existing-azure-openai-service).
+If there's an existing resource you'd rather use instead of provisioning a new resource, see the documentation for [Connecting to an existing Azure OpenAI service](https://aspire.dev/integrations/cloud/azure/azure-openai/azure-openai-get-started/).
 
-For more details on Aspire's Azure OpenAI integration, see the [official documentation](https://learn.microsoft.com/en-us/dotnet/aspire/azureai/azureai-openai-integration).
+For more details on Aspire's Azure OpenAI integration, see the [official documentation](https://aspire.dev/integrations/cloud/azure/azure-openai/azure-openai-get-started/).
 
 #### Manual Configuration (Without Aspire)