fix(docs): drop the any cast and only follow plain subBlocks spreads in the catalog generator

Author: waleedlatif1

scripts/check-explicit-any.baseline.json

@@ -1099,7 +1099,7 @@
     "scripts/check-fork-dependent-coverage.ts": 2,
     "scripts/check-import-specifiers.ts": 1,
     "scripts/create-single-release.ts": 2,
-    "scripts/generate-docs.ts": 41,
+    "scripts/generate-docs.ts": 40,
     "scripts/generate-v2-cli-api.ts": 3
   },
   "nonNullAssertion": {

scripts/generate-docs.ts

@@ -2238,14 +2238,16 @@ function extractSpreadBase(blockContent: string): string | null {
 /**
  * Operations a block inherits by spreading a same-file block's fields array
  * (`subBlocks: [...NotionBlock.subBlocks, ...]`) rather than the whole config.
+ * Only a plain spread counts: a transformed one (`...XBlock.subBlocks.map(...)`) may rewrite the
+ * operations, so it falls through to the block's own `tools.access`.
  */
 function extractSpreadSubBlocksOperations(
   blockContent: string,
   fileContent: string | undefined
 ): { label: string; id: string }[] {
   if (!fileContent) return []
   const declarations = blockDeclarations(fileContent)
-  for (const match of blockContent.matchAll(/\.\.\.(\w+Block)\.subBlocks\b/g)) {
+  for (const match of blockContent.matchAll(/\.\.\.(\w+Block)\.subBlocks\s*[,\]]/g)) {
     const declaration = declarations.find((candidate) => candidate.name === match[1])
     const operations = declaration ? extractOperationsFromContent(declaration.content) : []
     if (operations.length > 0) return operations
@@ -2354,7 +2356,7 @@ function extractBlockConfigFromContent(
     }
 
     const ownOperations = extractOperationsFromContent(blockContent)
-    const baseOperations: { label: string; id: string }[] = (baseConfig as any)?.operations ?? []
+    const baseOperations = baseConfig?.operations ?? []
     const operations =
       ownOperations.length > 0
         ? ownOperations