@inkdropapp/types

TypeScript type definitions for Inkdrop plugin development.

This package provides ambient type declarations for the inkdrop global object (the Environment class) and the 'inkdrop' module, giving plugin authors full IntelliSense and type-checking support.

Installation

npm install --save-dev @inkdropapp/types

Setup

Add @inkdropapp/types to your tsconfig.json:

{
  "compilerOptions": {
    "types": ["@inkdropapp/types"]
  }
}

This enables two things:

1. The inkdrop global -- typed as the Environment class, available in any file without importing
2. The 'inkdrop' module -- typed ambient module for import { ... } from 'inkdrop'

Usage

The inkdrop global

The inkdrop global provides access to the application environment -- managers for commands, keymaps, packages, notifications, the local database, and more.

// Access the config
const fontSize = inkdrop.config.get('editor.fontSize')

// Register a command
inkdrop.commands.add(document.body, {
  'my-plugin:do-something': () => {
    // ...
  }
})

// Query the local database
const note = await inkdrop.localDB.notes.get('note:abc123')

// Listen for editor load
inkdrop.onEditorLoad((editor) => {
  console.log('Editor loaded:', editor)
})

The 'inkdrop' module

Plugins can import utilities and models from the 'inkdrop' module. These are provided by Inkdrop at runtime and should not be bundled into your plugin.

import { models, logger, useModal, createLogger } from 'inkdrop'

// ORM models
const note = await models.Note.loadWithId('note:abc123')
note.title = 'Updated Title'
await note.save()

// Logging
logger.debug('Processing:', data)

const myLogger = createLogger('my-plugin')
myLogger.info('Plugin initialized')

// React hook for modals
function MyDialog() {
  const modal = useModal()
  return (
    <>
      <button onClick={modal.show}>Open</button>
      {modal.state.visible && <Dialog onClose={modal.close} />}
    </>
  )
}

Other exports from the 'inkdrop' module include:

• actions -- Redux action creators (typed as any)
• AssistiveError -- Error class with detail and debugInfo properties
• html2markdown -- Convert HTML strings to Markdown
• markdownRenderer -- The application's Markdown renderer
• exportUtils -- Export notes as HTML or Markdown
• importUtils -- Import Markdown or HTML files as notes

Command types

The package provides typed command maps for every scope in the application. Use these to get type-safe command dispatching:

import type {
  EnvironmentCommands,
  EditorCommands,
  MDELocalCommands
} from '@inkdropapp/types'

Each command map is a record of command names to their parameter types. Commands that take no parameters use undefined:

// EnvironmentCommands
'core:new-note': undefined
'core:open-note': { noteId: string; revision?: string; viewMode?: EditorViewMode }

// EditorCommands
'core:save-note': undefined
'editor:insert-text': { text: string; selection?: { anchor: number; head?: number } }

Available command scopes: EnvironmentCommands, WindowCommands, ApplicationCommands, EditorCommands, MDECommands, MDELocalCommands, MDEPreviewCommands, MDEPreviewLocalCommands, FindInNoteGlobalCommands, FindInNoteOnEditorLocalCommands, FindInNoteOnPreviewLocalCommands, NoteListBarLayoutCommands, NoteListBarCommands, NoteListSearchBarCommands, SidebarNavigationCommands, SidebarMenuCommands, SidebarMenuLocalCommands, SideBarMenuItemCommands, SidebarWorkspaceMenuCommands, SidebarWorkspaceMenuLocalCommands, EditorDrawerCommands, MainLayoutCommands, MDESearchBarLocalCommands, PreviewFindBarLocalCommands.

Importing individual types

All type definitions are also importable from @inkdropapp/types directly:

import type {
  Environment,
  Config,
  CommandRegistry,
  NotificationManager,
  IPCLocalDatabase,
  KeymapManager,
  PackageManager,
  MarkdownRenderer,
  ModelNote,
  ModelBook,
  Logger,
  EnvironmentCommands,
  EditorCommands
} from '@inkdropapp/types'

What's included

Environment & managers

| Type | Description | |------|-------------| | Environment | The main application environment (inkdrop global) | | Config | Application configuration with schema enforcement | | CommandRegistry | Register and dispatch commands | | KeymapManager | Keybinding management | | NotificationManager | User notifications | | PackageManager | Plugin lifecycle management | | ThemeManager | Theme management | | ComponentManager | Custom React component registry | | LayoutManager | UI layout management | | StyleManager | Stylesheet management | | MenuManager | Application menu management | | ContextMenuManager | Context menu management | | TelescopeManager | Telescope (command palette) sources | | MarkdownRenderer | Markdown-to-React rendering pipeline | | ApplicationDelegate | Platform-specific application delegate |

Commands

| Type | Description | |------|-------------| | EnvironmentCommands | Commands on the global scope (core:new-note, core:open-note, etc.) | | WindowCommands | Window management commands (window:reload, window:close, etc.) | | ApplicationCommands | Application-level commands (application:quit, application:open-preferences, etc.) | | EditorCommands | Editor component commands (core:save-note, editor:insert-images, etc.) | | MDECommands | Markdown editor global commands (editor:focus-mde, editor:add-extension, etc.) | | MDELocalCommands | Markdown editor local commands (cursor movement, text formatting, etc.) | | MDEPreviewCommands | Preview pane commands | | FindInNoteGlobalCommands | Find/replace commands (global) | | NoteListBarLayoutCommands | Note list navigation commands | | SidebarMenuCommands | Sidebar commands | | MainLayoutCommands | Layout toggle commands | | EditorViewMode | Editor view mode union type ('preview' \| 'sideBySide' \| 'edit') |

IPC (Inter-Process Communication)

| Type | Description | |------|-------------| | IPCLocalDatabase | Local PouchDB database access (notes, books, tags, files) | | IPCWindow | Window management | | IPCDialog | Native dialog access | | IPCClipboard | Clipboard access |

'inkdrop' module types

| Type | Description | |------|-------------| | ModelNote, ModelBook, ModelTag, ModelFile | ORM model classes | | Logger | Logger interface | | NoteExportHelper, NoteExporter | Note export utilities | | NoteImportHelper, NoteImporter | Note import utilities | | UseModalResult, ModalState | Modal hook types |

Dependencies

This package depends on the following for their type definitions. Inkdrop provides these at runtime -- plugins should externalize them in their bundler config:

• @codemirror/commands, @codemirror/language, @codemirror/search, @codemirror/state, @codemirror/view
• inkdrop-model
• redux
• glob

Links

• Inkdrop Plugin Development Guide
• Inkdrop SDK Repository