我使用了很多自己的和第三方的库。我看到“typings”目录包含一些Jquery和WinRT…但它们是如何产生的呢?


当前回答

在创建自己的库时,您可以创建*.d。ts文件使用tsc (TypeScript编译器)命令,如下所示: (假设您正在将库构建到dist/lib文件夹)

tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly

-d(——declaration):生成*.d。ts文件 ——declarationDir dist/lib:生成声明文件的输出目录。 ——declarationMap:为每个对应的' .d生成一个源地图。ts文件。 ——emitDeclarationOnly:只释放' .d。Ts的声明文件。(没有编译过的JS)

(查看文档了解所有命令行编译器选项)

或者在你的package.json中:

"scripts": {
    "build:types": "tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly",
}

然后run: yarn build:types(或NPM run build:types)

其他回答

处理这种情况(如果DefinitelyTyped上没有声明文件)的最佳方法是仅为所使用的内容而不是整个库编写声明。这大大减少了工作——此外,编译器可以通过抱怨丢失的方法来帮助解决问题。

在创建自己的库时,您可以创建*.d。ts文件使用tsc (TypeScript编译器)命令,如下所示: (假设您正在将库构建到dist/lib文件夹)

tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly

-d(——declaration):生成*.d。ts文件 ——declarationDir dist/lib:生成声明文件的输出目录。 ——declarationMap:为每个对应的' .d生成一个源地图。ts文件。 ——emitDeclarationOnly:只释放' .d。Ts的声明文件。(没有编译过的JS)

(查看文档了解所有命令行编译器选项)

或者在你的package.json中:

"scripts": {
    "build:types": "tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly",
}

然后run: yarn build:types(或NPM run build:types)

这个答案展示了如何在一个独立的函数中使用typescript编译器API:

import ts from 'typescript';
function createDTsTextsFromJsFilePaths(
  jsFileNames: string[]
): Record<string, string> {
  const options = {
    allowJs: true,
    declaration: true,
    emitDeclarationOnly: true,
  };
  // Create a Program with an in-memory emit
  const createdFiles: Record<string, string> = {};
  const host = ts.createCompilerHost(options);
  host.writeFile = (fileName: string, contents: string): void => {
    const dtsName = fileName.replace('.js', '.d.ts');
    createdFiles[dtsName] = contents;
  };
  // Prepare and emit the d.ts files
  const program = ts.createProgram(jsFileNames, options, host);
  program.emit();
  return createdFiles;
}
////////////// test code below here ///////////////////////////////////
import fs from 'fs'
const jsTest = 
`
"use strict"
function x(){
  return {
    a: 1, 
    b: ()=>'hello'
  }
}
`;
const jsPath = '/tmp/jstest.js';
fs.writeFileSync(jsPath, jsTest);
const createdFiles = createDTsTextsFromJsFilePaths([jsPath]);
for (const dtsName in createdFiles) {
  console.log('================');
  console.log(dtsName);
  console.log('----------------');
  console.log(createdFiles[dtsName]);
}

测试的执行会给出结果

================
/tmp/jstest.d.ts
----------------
declare function x(): {
    a: number;
    b: () => string;
};

该函数来源于类型脚本编译器API指南中的文档

我会寻找支持script#或SharpKit的第三方JS库的现有映射。使用这些c#到。js交叉编译器的用户可能会遇到你现在面临的问题,并且可能已经发布了一个开源程序来扫描你的第三方库并将其转换为框架c#类。如果是这样的话,破解扫描器程序,生成TypeScript代替c#。

如果做不到这一点,将第三方库的c#公共接口转换为TypeScript定义可能比读取源JavaScript更简单。

我特别感兴趣的是Sencha的ExtJS RIA框架,我知道已经发布了为script#或SharpKit生成c#解释的项目

正如Ryan所说,tsc编译器有一个switch——声明,它生成一个.d。Ts文件中的。Ts文件。还要注意(排除bug) TypeScript应该能够编译Javascript,所以你可以将现有的Javascript代码传递给tsc编译器。