This package contains type definitions for Zotero (https://www.zotero.org/) plugin.

npm package: https://www.npmjs.com/package/zotero-types

Run npm install --save-dev zotero-types.

You can include the type definitions in your Zotero plugin project in three ways:

1. Extend the tsconfig.json file in your Zotero plugin project. This is the recommended way.

// tsconfig.json
{
  "extends": "zotero-types/entries/sandbox",
}

For the best practices, see https://github.com/windingwind/know-ur-zotero as a reference.

Available entries:

2. Use compileOptions > types in your Zotero plugin project's tsconfig.json file.

// tsconfig.json
{
  "compilerOptions": {
    "types": ["zotero-types"],
  },
}

This is equivalent to the combination of sandbox and xhtml entries.

3. Use triple-slash directive in your Zotero plugin project's d.ts file.

Similar to the tsconfig.json file, you can use the /// <reference path="..." /> directive to include the type definitions.

/// <reference types="zotero-types/entries/sandbox/index.d.ts" />

// Example 1: get Zotero.Item by id
const item = Zotero.Items.get(1234);

// Example 2: use XUL.Element type with specific properties
const exportFiles = document.querySelector(
  "#menu_export_files",
) as XULMenuItemElement;
exportFiles.disabled = true;

// Example 3: use platform APIs (OS)
const filepath = "/path/to/file";
if (await IOUtils.exists(filepath)) {
  let contentRaw = await IOUtils.readUTF8(filepath);
}

This type definition only contains frequently used typings and is not complete. Please check the source code of Zotero here: https://github.com/zotero/zotero.

The d.ts files of Zotero are set accordingly to their corresponding file in the Zotero repository.

Planning to merge to https://github.com/DefinitelyTyped/DefinitelyTyped/

To release this to the npm package, use npm run release.

Use this code under MIT License. No warranties are provided. Keep the laws of your locality in mind!

If you want to change the license, please contact me at [email protected]

Part of the code of this repo refers to other open-source projects within the allowed scope.

• zotero-better-bibtex(d.ts)