An example definition showing how to provide a definition file for a package without defining the entire thing.

shim-definitions.d.ts

declare module 'shim-definitions' { // This module name should match the package name.
  /**
   * This allows something like VSCode to auto-import with the name
   * `shimDefinitions`. It could be any other name you want.
   */
  const shimDefinitions: any;

  /**
   * Doing this allows you to import like so:
   * ```ts
   * import shimDefinitions from 'shim-definitions';
   * ```
   */
  export default shimDefinitions;

  /**
   * To allow importing of specific declarations from the package, you can do something
   * like this.
   */
  export const ExampleClass: any;
  /**
   * You can then import using
   * ```ts
   * import { ExampleClass } from 'shim-definitions';
   * ```
   * and use it normally. This would also allow you to build up the definition over time,
   * so you could eventually turn it into:
   * ```ts
   * export class ExampleClass {
   *   exampleMethod(opts: object): string;
   * }
   * ```
   * This lets you type something you know and use, and leave other things out, saving time
   * building the whole definition.
   */
}