Function createExampleImportPolicy

packages/tools/jsdocs/src/Jsdocs.ts:2481–2519

(files: ReadonlyArray<JSDocModelFile>)

}

function createExampleImportPolicy(files: ReadonlyArray<JSDocModelFile>): ExampleImportPolicy {
  const allowedNamed = new Map<string, Set<string>>()
  const namespaceModuleBySource = new Map<string, { readonly barrelModule: string; readonly name: string }>()
  const flatModuleBySource = new Map<string, { readonly barrelModule: string; readonly names: ReadonlySet<string> }>()
  const namedModuleBySource = new Map<string, ReadonlySet<string>>()
  const addAllowed = (source: string, name: string) => {
    const names = allowedNamed.get(source) ?? new Set<string>()
    names.add(name)
    allowedNamed.set(source, names)
  }
  for (const file of files) {
    if (file.imports === undefined) continue
    const rootValues = file.declarations.filter((declaration) =>
      declaration.bucket === "value" && isIdentifierName(declaration.name)
    ).map((declaration) => declaration.name)
    if (file.imports.barrel?.type === "namespace") {
      addAllowed(file.imports.barrel.module, file.imports.barrel.name)
      for (const name of file.imports.flatNames) addAllowed(file.imports.barrel.module, name)
      namespaceModuleBySource.set(file.imports.module, {
        barrelModule: file.imports.barrel.module,
        name: file.imports.barrel.name
      })
      continue
    }
    if (file.imports.barrel?.type === "flat") {
      for (const name of new Set([...rootValues, ...file.imports.flatNames])) {
        addAllowed(file.imports.barrel.module, name)
      }
      flatModuleBySource.set(file.imports.module, {
        barrelModule: file.imports.barrel.module,
        names: new Set([...rootValues, ...file.imports.flatNames])
      })
      continue
    }
    for (const name of rootValues) addAllowed(file.imports.module, name)
    namedModuleBySource.set(file.imports.module, new Set(rootValues))
  }
  return { allowedNamedBySource: allowedNamed, namespaceModuleBySource, flatModuleBySource, namedModuleBySource }
}

function importSpecifierName(specifier: ts.ImportSpecifier): string {
  return specifier.propertyName?.text ?? specifier.name.text