Update dependency typescript to v6 (#796)

* Update dependency typescript to v6

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Re-baseline tsconfig from fresh Docusaurus scaffold

Silences the baseUrl deprecation warning via ignoreDeprecations
and enables strict mode, matching what a fresh Docusaurus 3.10
scaffold produces.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Fix sidebars.ts type error from JSON-imported CRD sidebar

TypeScript infers JSON import fields as widened strings, so
crdSidebar.type was "string" instead of "category". That made
the whole sidebar array fail to match SidebarItemConfig[] and
cascaded into bogus errors on every bare doc-ID string.

Cast the imported JSON to the extracted item type to break
the cascade. The type is derived from SidebarsConfig so it
stays accurate without importing from internal paths.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Fix type errors in custom components for TS 6

- mcp-metadata-plugin: narrow caught error with instanceof Error
  before reading .message (TS 6 defaults catches to unknown).
- CRDReference: cast JSON-imported schemas to the minimal Schema
  interface; the upstream JSON carries extra x-kubernetes-* fields
  that don't structurally match.
- HubSpotForm: declare window.hbspt via a global interface and
  switch to property access.
- Admonition/Types: pass the now-required type prop to
  AdmonitionLayout.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 3 people

package-lock.json

@@ -51,7 +51,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
     "prettier": "^3.8.3",
-    "typescript": "~5.9.3",
+    "typescript": "~6.0.3",
     "typescript-eslint": "^8.58.2",
     "yaml": "^2.8.3"
   },

package.json

@@ -10,6 +10,6 @@
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "typescript": "~5.9.3"
+    "typescript": "~6.0.3"
   }
 }

plugins/mcp-metadata-plugin/package.json

@@ -59,8 +59,10 @@ export default function mcpMetadataPlugin(
           }
 
           // Store error message as fallback
+          const message =
+            error instanceof Error ? error.message : String(error);
           serverData[serverName] = `# Error fetching data for ${serverName}
-# ${error.message}
+# ${message}
 # Please check that the server exists in the registry and thv command is available`;
         }
       }

plugins/mcp-metadata-plugin/src/index.ts

@@ -1,6 +1,10 @@
 import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
 import { buildCliReferenceSidebar } from './src/utils/buildHierarchicalSidebar';
-import crdSidebar from './static/api-specs/crds/sidebar.json';
+import crdSidebarJson from './static/api-specs/crds/sidebar.json';
+
+type SidebarItemConfig = SidebarsConfig[string] extends (infer T)[] ? T : never;
+
+const crdSidebar = crdSidebarJson as SidebarItemConfig;
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
 

sidebars.ts

@@ -264,7 +264,7 @@ export function CRDFields({
   include,
   exclude,
 }: CRDFieldsProps): React.ReactNode {
-  const schema = schemas[kind as CRDKind];
+  const schema = schemas[kind as CRDKind] as unknown as Schema;
   if (!schema) {
     return (
       <div className={styles.error}>

src/components/CRDReference/index.tsx

@@ -27,6 +27,24 @@ interface HubSpotFormProps {
   anchorId?: string;
 }
 
+interface HubSpotFormCreateOptions {
+  portalId: string;
+  formId: string;
+  region: string;
+  target: string;
+  onFormSubmitted?: () => void;
+}
+
+declare global {
+  interface Window {
+    hbspt?: {
+      forms: {
+        create: (options: HubSpotFormCreateOptions) => void;
+      };
+    };
+  }
+}
+
 const SCRIPT_SRC = '//js-na2.hsforms.net/forms/embed/v2.js';
 
 export default function HubSpotForm({
@@ -46,7 +64,7 @@ export default function HubSpotForm({
     if (!containerRef.current) return;
 
     const init = () => {
-      window['hbspt'].forms.create({
+      window.hbspt?.forms.create({
         portalId,
         formId,
         region,
@@ -55,7 +73,7 @@ export default function HubSpotForm({
       });
     };
 
-    if (window['hbspt']) {
+    if (window.hbspt) {
       init();
       return;
     }

src/components/HubSpotForm/index.tsx

@@ -29,6 +29,7 @@ interface EnterpriseAdmonitionProps {
 function EnterpriseAdmonition(props: EnterpriseAdmonitionProps): ReactNode {
   return (
     <AdmonitionLayout
+      type='enterprise'
       icon={<StacklokIcon />}
       title={props.title ?? 'Stacklok Enterprise'}
       className={`alert alert--enterprise ${props.className ?? ''}`}

src/theme/Admonition/Types.tsx

@@ -1,9 +1,13 @@
+// This file is not used by "docusaurus start/build" commands.
+// It is here to improve your IDE experience (type-checking, autocompletion...),
+// and can also run the package.json "typecheck" script manually.
 {
-  // This file is not used in compilation. It is here just for a nice editor experience.
   "extends": "@docusaurus/tsconfig",
   "compilerOptions": {
     "baseUrl": ".",
-    "resolveJsonModule": true
+    "ignoreDeprecations": "6.0",
+    "resolveJsonModule": true,
+    "strict": true
   },
   "exclude": [".docusaurus", "build"]
 }