release: promote next to main (#754)

Promote next after resolving conflicts and review feedback.

Author: ss-o

docs/index.mdx

@@ -66,13 +66,13 @@ Zi is a Swiss Army Knife for Zsh — a blazing-fast plugin manager with Turbo mo
     alt="Z-Shell Metrics"
     width="100%"
     height="auto"
-    img="https://raw.githubusercontent.com/z-shell/.github/main/metrics/plugin/metrics.svg"
+    img="https://raw.githubusercontent.com/z-shell/.github/metrics/metrics/plugin/metrics.svg"
   />
   <ImgShow
     alt="Z-Shell Repositories"
     width="100%"
     height="auto"
-    img="https://raw.githubusercontent.com/z-shell/.github/main/metrics/plugin/repositories_metrics.svg"
+    img="https://raw.githubusercontent.com/z-shell/.github/metrics/metrics/plugin/repositories_metrics.svg"
   />
 </Link>
 

ecosystem/plugins/zsh_lint.mdx

@@ -2,50 +2,39 @@
 id: zsh_lint
 title: 🔍 Zsh Lint
 sidebar_position: 13
-description: A Zi-aware linter for Zsh configuration and scripting.
+description: A Go-based semantic analyzer for Zsh.
 keywords:
   - zsh-lint
   - linter
-  - zi
+  - zsh
+  - go
 ---
 
 {/* @format */}
 
-import Tabs from "@theme/Tabs";
-import TabItem from "@theme/TabItem";
+## A Go-based semantic analyzer for Zsh
 
-## Zi-aware Linter for Zsh scripting language
-
-`zsh-lint` is a powerful linter designed specifically for Zsh. It understands Zi-specific constructs and helps ensure your configuration and scripts are following best practices and are free of syntax errors.
+`zsh-lint` is being rebooted as a Go semantic analyzer for Zsh. It parses Zsh
+sources with a real grammar front end and reports problems. It currently
+operates as a **parser survey** — reporting which files the parser accepts — and
+does not implement lint rules yet.
 
 ### <i class="fa-brands fa-github"></i> [z-shell/zsh-lint][]
 
 ### Installation
 
-<Tabs>
-  <TabItem value="zi" label="Zi" default>
-
-Add the following to your `.zshrc` file:
-
-```zsh title="~/.zshrc"
-zi light z-shell/zui
-zi light z-shell/zsh-lint
+```sh
+go install github.com/z-shell/zsh-lint/cmd/zsh-lint@latest
 ```
 
-Note: `zsh-lint` requires [ZUI](zui) to be loaded as well.
-
-  </TabItem>
-  <TabItem value="standalone" label="Standalone">
-
-Clone the repository and source the plugin:
+### Usage
 
-```shell title="~/.zshrc"
-git clone https://github.com/z-shell/zsh-lint.git
-source path/to/zsh-lint/zsh-lint.plugin.zsh
+```sh
+zsh-lint path/to/file.zsh another.zsh
 ```
 
-  </TabItem>
-</Tabs>
+Each file gets an `OK`/`FAIL` line; failures include a greppable
+`path:line:col: message`. The exit code is `0` only if every file parsed.
 
 {/* end-of-file */}
 {/* links */}

functions/[[path]].ts

@@ -4,6 +4,8 @@ interface Env {
   ASSETS_BUCKET: R2Bucket;
 }
 
+const immutableAssetPrefixes = ["/assets/", "/cdn/", "/img/"];
+
 export const onRequest: PagesFunction<Env> = async (context) => {
   if (context.request.method === "OPTIONS") {
     return new Response(null, {
@@ -46,7 +48,11 @@ export const onRequest: PagesFunction<Env> = async (context) => {
 
   const headers = new Headers();
   object.writeHttpMetadata(headers);
-  headers.set("Cache-Control", "public, max-age=31536000, immutable");
+  if (immutableAssetPrefixes.some((prefix) => url.pathname.startsWith(prefix))) {
+    headers.set("Cache-Control", "public, max-age=31536000, immutable");
+  } else if (!headers.has("Cache-Control")) {
+    headers.set("Cache-Control", "public, max-age=300");
+  }
   headers.set("ETag", object.httpEtag);
   headers.set("Access-Control-Allow-Origin", "*");
   headers.set("Accept-Ranges", "bytes");

package.json

@@ -19,12 +19,13 @@
     "lint:links": "trunk check --filter lychee",
     "lint:links:all": "trunk check --all --filter lychee",
     "lint:links:refresh": "trunk check --all --filter lychee --cache=false",
-    "project-health": "pnpm lint && pnpm build:en",
+    "project-health": "pnpm lint && pnpm wrangler:typecheck && pnpm build:en",
     "serve": "docusaurus serve",
     "start": "docusaurus start",
     "start:cf": "wrangler pages dev build --remote",
     "swizzle": "docusaurus swizzle",
     "validate:frontmatter": "node scripts/validate-frontmatter.mjs",
+    "wrangler:typecheck": "tsc -p functions/tsconfig.json",
     "wrangler:types": "wrangler types --path='./functions/worker-env.d.ts'",
     "write-docs-version": "docusaurus docs:version",
     "write-heading-ids": "docusaurus write-heading-ids",

pnpm-workspace.yaml

@@ -15,3 +15,9 @@ overrides:
   webpackbar: "^7.0.0"
   serialize-javascript: "7.0.5"
   uuid: "14.0.0"
+
+# Allow ESLint 10 (current stable) for plugins whose declared peer range
+# predates it but which work fine with it. Removes install-time peer warnings.
+peerDependencyRules:
+  allowedVersions:
+    "eslint-plugin-jsx-a11y>eslint": "^10"

src/components/HomeBanner/index.tsx

@@ -44,7 +44,7 @@ export default function HeroBanner(): React.JSX.Element {
             <iframe
               className={styles.indexCtasGitHubButton}
               src="https://ghbtns.com/github-btn.html?user=z-shell&amp;repo=zi&amp;type=star&amp;count=true&amp;size=large"
-              width={130}
+              width={170}
               height={30}
               title="GitHub Stars"
               loading="lazy"