guardrails: document vendor type shims

Author: div0rce

types/vendor/next-cache.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-cache.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/cache' {
   export { unstable_cache } from 'next/dist/server/web/spec-extension/unstable-cache.js';
 

types/vendor/next-font-google.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-font-google.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/font/google' {
   export * from 'next/dist/compiled/@next/font/dist/google/index.js';
 }

types/vendor/next-font-local.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-font-local.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/font/local' {
   export { default } from 'next/dist/compiled/@next/font/dist/local/index.js';
 }

types/vendor/next-headers.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-headers.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/headers' {
   export * from 'next/dist/server/request/cookies.js';
   export * from 'next/dist/server/request/headers.js';

types/vendor/next-image-types-global.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-image-types-global.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 // this file is conditionally added/removed to next-env.d.ts
 // if the static image import handling is enabled
 

types/vendor/next-link.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-link.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/link' {
   export * from 'next/dist/client/link.js';
   const Link: typeof import('next/dist/client/link.js').default;

types/vendor/next-navigation.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-navigation.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/navigation' {
   export * from 'next/dist/client/components/navigation.js';
 }

types/vendor/next-server.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/next-server.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/server' {
   import type { AsyncLocalStorage as NodeAsyncLocalStorage } from 'async_hooks';
 

types/vendor/vercel-og-satori.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/vercel-og-satori.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/dist/compiled/@vercel/og/satori' {
   export type SatoriOptions = {
     fonts?: unknown;

types/vendor/vercel-og-types.d.ts

@@ -1,3 +1,11 @@
+/**
+ * VENDOR SHIM
+ * Reason: NodeNext/ESM requires explicit extensions; vendor .d.ts import paths violate NodeNext.
+ * Scope: types/vendor/vercel-og-types.d.ts
+ * Version: next@16.0.8
+ * Audit: 2026-01-27
+ */
+
 declare module 'next/dist/compiled/@vercel/og/types' {
   export type ImageResponseOptions = Record<string, unknown>;
 }