nuxt-seo-utils 8.6.0 → 9.0.0

package/README.md

@@ -1,17 +1,10 @@
-<h1>nuxt-seo-utils</h1>
+<h1><a href="https://nuxtseo.com"><img src=".github/assets/icon.svg" width="40" height="40" alt="Nuxt SEO" align="top"></a> nuxt-seo-utils</h1>
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![License][license-src]][license-href]
 [![Nuxt][nuxt-src]][nuxt-href]
-
-<a href="https://skilld.dev/gh/harlan-zw/nuxt-seo-utils">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://skilld.dev/b/harlan-zw/nuxt-seo-utils?theme=dark">
-    <source media="(prefers-color-scheme: light)" srcset="https://skilld.dev/b/harlan-zw/nuxt-seo-utils?theme=light">
-    <img alt="Skill repository on skilld.dev" src="https://skilld.dev/b/harlan-zw/nuxt-seo-utils?theme=light">
-  </picture>
-</a>
+[![Skill repository on skilld.dev][skilld-src]][skilld-href]
 
 Nuxt SEO Utils is a collection of defaults and utilities to improve your Nuxt site's discoverability and shareability.
 
@@ -37,14 +30,14 @@ While there are several features covering many aspects of SEO, it covers importa
 - 🧩 Site config template params `useHead({ title: '%site.title' })`
 - 🍞 Breadcrumb composable
 - 🧙 Best practice defaults and enhanced titles
-- ⚡ Inline minification of `<script>` and `<style>` tags (esbuild + lightningcss at build, lightweight runtime fallback)
+- ⚡ Parser-based minification of static JavaScript and CSS at build time, plus optional JSON/CSS minification during SSR
 
 ## Installation
 
 Install `nuxt-seo-utils` dependency to your project:
 
 ```bash
-npx nuxi@latest module add nuxt-seo-utils
+npx nuxt module add nuxt-seo-utils
 ```
 
 > [!TIP]
@@ -73,14 +66,17 @@ npx nuxi@latest module add nuxt-seo-utils
 Licensed under the [MIT license](https://github.com/harlan-zw/nuxt-seo-utils/blob/main/LICENSE.md).
 
 <!-- Badges -->
-[npm-version-src]: https://img.shields.io/npm/v/nuxt-seo-utils/latest.svg?style=flat&colorA=18181B&colorB=28CF8D
+[npm-version-src]: https://img.shields.io/npm/v/nuxt-seo-utils/latest.svg?style=flat&labelColor=16152b&color=00a63e
 [npm-version-href]: https://npmjs.com/package/nuxt-seo-utils
 
-[npm-downloads-src]: https://img.shields.io/npm/dm/nuxt-seo-utils.svg?style=flat&colorA=18181B&colorB=28CF8D
+[npm-downloads-src]: https://img.shields.io/npm/dm/nuxt-seo-utils.svg?style=flat&labelColor=16152b&color=00a63e
 [npm-downloads-href]: https://npmjs.com/package/nuxt-seo-utils
 
-[license-src]: https://img.shields.io/github/license/harlan-zw/nuxt-seo-utils.svg?style=flat&colorA=18181B&colorB=28CF8D
+[license-src]: https://img.shields.io/github/license/harlan-zw/nuxt-seo-utils.svg?style=flat&labelColor=16152b&color=00a63e
 [license-href]: https://github.com/harlan-zw/nuxt-seo-utils/blob/main/LICENSE.md
 
-[nuxt-src]: https://img.shields.io/badge/Nuxt-18181B?logo=nuxt
+[nuxt-src]: https://img.shields.io/badge/Nuxt-16152b?logo=nuxt&style=flat
 [nuxt-href]: https://nuxt.com
+
+[skilld-src]: https://skilld.dev/b/harlan-zw/nuxt-seo-utils?style=flat&labelColor=16152b&color=00a63e&logoColor=ffffff
+[skilld-href]: https://skilld.dev/gh/harlan-zw/nuxt-seo-utils

package/dist/cli.mjs

@@ -9,7 +9,7 @@ import { p as pngToIco } from './shared/nuxt-seo-utils.NAV2YNQn.mjs';
 import 'node:buffer';
 
 const name = "nuxt-seo-utils";
-const version = "8.6.0";
+const version = "9.0.0";
 const description = "SEO utilities to improve your Nuxt sites discoverability and shareability";
 
 const ICON_SIZES = [

package/dist/module.d.mts

@@ -1,6 +1,35 @@
 import * as _nuxt_schema from '@nuxt/schema';
 import { MetaFlatSerializable } from '../dist/runtime/types.js';
 
+/** A calendar date, such as `'2026-10-13'`. */
+type RedirectDate = `${number}-${number}-${number}`;
+interface RedirectMeta {
+    /** The date you added the entry. The review clock starts here. */
+    addedAt: RedirectDate;
+    /** The date you last decided to keep the entry. It restarts the review clock. */
+    reviewedAt?: RedirectDate;
+    /** A private note for the site owner. Visitors never see it. */
+    reason?: string;
+}
+/** The old URL moved. Requests get a permanent redirect to `to`. */
+interface MovedUrl extends RedirectMeta {
+    /** A path on this site, such as `/blog/new-post`, or an absolute URL. End it with `/**` to keep the rest of a `/**` source path. */
+    to: string;
+    /** @default 301 */
+    statusCode?: 301 | 308;
+}
+/** The old URL has no replacement. Requests get the error page with this status. */
+interface GoneUrl extends RedirectMeta {
+    to?: never;
+    statusCode: 410 | 404;
+}
+type RedirectInput = MovedUrl | GoneUrl;
+/**
+ * Old URLs keyed by path, without `app.baseURL`.
+ * A trailing `/**` matches the path and every path below it.
+ */
+type Redirects = Record<string, RedirectInput>;
+
 interface ModuleOptions {
     /**
      * Whether the SEO experiements should run.
@@ -104,6 +133,29 @@ interface ModuleOptions {
      * @default false
      */
     redirectToCanonicalSiteUrl?: boolean;
+    /**
+     * Old URLs keyed by path, without `app.baseURL`. A trailing `/**` matches the path and every path below it.
+     *
+     * - A moved URL sets `to`. Requests get a permanent redirect (301, or 308).
+     * - A gone URL sets `statusCode: 410` (or 404) and no `to`. Requests get the error page with that status.
+     *
+     * Every entry records `addedAt`. The build lists entries older than `redirectReviewAfterDays` for review.
+     * No entry expires on its own.
+     *
+     * @example
+     * redirects: {
+     *   '/old-post': { to: '/blog/new-post', addedAt: '2026-10-13' },
+     *   '/spring-sale': { statusCode: 410, addedAt: '2026-10-13', reason: 'The sale ended.' },
+     * }
+     */
+    redirects?: Redirects;
+    /**
+     * Days after an entry's `addedAt` or `reviewedAt` until `nuxt dev` and `nuxt build` list it for review.
+     * Set `false` to turn off the review.
+     *
+     * @default 365
+     */
+    redirectReviewAfterDays?: number | false;
     /**
      * Sets the `tagPriority` for SEO and Open Graph meta tags generated by this module.
      * Uses unhead's priority aliases: `'low'` (default) ensures module tags act as fallbacks
@@ -124,8 +176,8 @@ interface ModuleOptions {
      * - `false`: Disabled.
      * - `{ build?: boolean, runtime?: boolean }`: Toggle each mode independently.
      *
-     * **Build mode**: Minifies static `app.head` scripts/styles and prerendered route HTML using esbuild (JS) and lightningcss (CSS).
-     * **Runtime mode**: Minifies all inline scripts/styles per SSR request via an Unhead `ssr:render` plugin using lightweight pure JS minifiers.
+     * **Build mode**: Minifies static `app.head` JavaScript/styles with parser-based tooling, plus JSON/CSS in prerendered HTML.
+     * **Runtime mode**: Minifies inline JSON/CSS per SSR request. Preserves dynamic JavaScript and custom script types.
      *
      * @default { build: true, runtime: false }
      */
@@ -150,4 +202,4 @@ interface ModuleOptions {
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
 export { _default as default };
-export type { ModuleOptions };
+export type { GoneUrl, ModuleOptions, MovedUrl, RedirectDate, RedirectInput, Redirects };

package/dist/module.d.ts

@@ -1,6 +1,35 @@
 import * as _nuxt_schema from '@nuxt/schema';
 import { MetaFlatSerializable } from '../dist/runtime/types.js';
 
+/** A calendar date, such as `'2026-10-13'`. */
+type RedirectDate = `${number}-${number}-${number}`;
+interface RedirectMeta {
+    /** The date you added the entry. The review clock starts here. */
+    addedAt: RedirectDate;
+    /** The date you last decided to keep the entry. It restarts the review clock. */
+    reviewedAt?: RedirectDate;
+    /** A private note for the site owner. Visitors never see it. */
+    reason?: string;
+}
+/** The old URL moved. Requests get a permanent redirect to `to`. */
+interface MovedUrl extends RedirectMeta {
+    /** A path on this site, such as `/blog/new-post`, or an absolute URL. End it with `/**` to keep the rest of a `/**` source path. */
+    to: string;
+    /** @default 301 */
+    statusCode?: 301 | 308;
+}
+/** The old URL has no replacement. Requests get the error page with this status. */
+interface GoneUrl extends RedirectMeta {
+    to?: never;
+    statusCode: 410 | 404;
+}
+type RedirectInput = MovedUrl | GoneUrl;
+/**
+ * Old URLs keyed by path, without `app.baseURL`.
+ * A trailing `/**` matches the path and every path below it.
+ */
+type Redirects = Record<string, RedirectInput>;
+
 interface ModuleOptions {
     /**
      * Whether the SEO experiements should run.
@@ -104,6 +133,29 @@ interface ModuleOptions {
      * @default false
      */
     redirectToCanonicalSiteUrl?: boolean;
+    /**
+     * Old URLs keyed by path, without `app.baseURL`. A trailing `/**` matches the path and every path below it.
+     *
+     * - A moved URL sets `to`. Requests get a permanent redirect (301, or 308).
+     * - A gone URL sets `statusCode: 410` (or 404) and no `to`. Requests get the error page with that status.
+     *
+     * Every entry records `addedAt`. The build lists entries older than `redirectReviewAfterDays` for review.
+     * No entry expires on its own.
+     *
+     * @example
+     * redirects: {
+     *   '/old-post': { to: '/blog/new-post', addedAt: '2026-10-13' },
+     *   '/spring-sale': { statusCode: 410, addedAt: '2026-10-13', reason: 'The sale ended.' },
+     * }
+     */
+    redirects?: Redirects;
+    /**
+     * Days after an entry's `addedAt` or `reviewedAt` until `nuxt dev` and `nuxt build` list it for review.
+     * Set `false` to turn off the review.
+     *
+     * @default 365
+     */
+    redirectReviewAfterDays?: number | false;
     /**
      * Sets the `tagPriority` for SEO and Open Graph meta tags generated by this module.
      * Uses unhead's priority aliases: `'low'` (default) ensures module tags act as fallbacks
@@ -124,8 +176,8 @@ interface ModuleOptions {
      * - `false`: Disabled.
      * - `{ build?: boolean, runtime?: boolean }`: Toggle each mode independently.
      *
-     * **Build mode**: Minifies static `app.head` scripts/styles and prerendered route HTML using esbuild (JS) and lightningcss (CSS).
-     * **Runtime mode**: Minifies all inline scripts/styles per SSR request via an Unhead `ssr:render` plugin using lightweight pure JS minifiers.
+     * **Build mode**: Minifies static `app.head` JavaScript/styles with parser-based tooling, plus JSON/CSS in prerendered HTML.
+     * **Runtime mode**: Minifies inline JSON/CSS per SSR request. Preserves dynamic JavaScript and custom script types.
      *
      * @default { build: true, runtime: false }
      */
@@ -150,4 +202,4 @@ interface ModuleOptions {
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
 export { _default as default };
-export type { ModuleOptions };
+export type { GoneUrl, ModuleOptions, MovedUrl, RedirectDate, RedirectInput, Redirects };

package/dist/module.json

@@ -2,9 +2,9 @@
   "name": "nuxt-seo-utils",
   "configKey": "seo",
   "compatibility": {
-    "nuxt": ">=3.16.0"
+    "nuxt": "^4.6.0 || ^5.0.0-0"
   },
-  "version": "8.6.0",
+  "version": "9.0.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"