Keep typedefs from overtype repo.

Author: WebsByTodd

browser-extension/src/overtype/overtype.d.ts

@@ -1,40 +1,147 @@
-interface OverTypeOptions {
+// Type definitions for OverType
+// Project: https://github.com/panphora/overtype
+// Definitions generated from JSDoc comments and implementation
+
+export interface Theme {
+  name: string;
+  colors: {
+    bgPrimary?: string;
+    bgSecondary?: string;
+    text?: string;
+    textSecondary?: string;
+    h1?: string;
+    h2?: string;
+    h3?: string;
+    strong?: string;
+    em?: string;
+    link?: string;
+    code?: string;
+    codeBg?: string;
+    blockquote?: string;
+    hr?: string;
+    syntaxMarker?: string;
+    listMarker?: string;
+    cursor?: string;
+    selection?: string;
+    rawLine?: string;
+    // Toolbar theme colors
+    toolbarBg?: string;
+    toolbarIcon?: string;
+    toolbarHover?: string;
+    toolbarActive?: string;
+    border?: string;
+  };
+}
+
+export interface Stats {
+  words: number;
+  chars: number;
+  lines: number;
+  line: number;
+  column: number;
+}
+
+export interface MobileOptions {
   fontSize?: string;
-  lineHeight?: number;
+  padding?: string;
+  lineHeight?: string | number;
+}
+
+export interface Options {
+  // Typography
+  fontSize?: string;
+  lineHeight?: string | number;
   fontFamily?: string;
-  theme?: string | ThemeObject;
+  padding?: string;
+
+  // Mobile responsive
+  mobile?: MobileOptions;
+
+  // Native textarea attributes (v1.1.2+)
+  textareaProps?: Record<string, any>;
+
+  // Behavior
   autofocus?: boolean;
+  autoResize?: boolean;      // v1.1.2+ Auto-expand height with content
+  minHeight?: string;         // v1.1.2+ Minimum height for autoResize mode
+  maxHeight?: string | null;  // v1.1.2+ Maximum height for autoResize mode
   placeholder?: string;
   value?: string;
-  autoResize?: boolean;
-  minHeight?: string;
-  maxHeight?: string;
-  padding?: string;
+
+  // Features
+  showActiveLineRaw?: boolean;
+  showStats?: boolean;
   toolbar?: boolean;
-  onChange?: (value: string) => void;
-  onKeydown?: (event: KeyboardEvent) => void;
+  statsFormatter?: (stats: Stats) => string;
+
+  // Theme (deprecated in favor of global theme)
+  theme?: string | Theme;
+  colors?: Partial<Theme['colors']>;
+
+  // Callbacks
+  onChange?: (value: string, instance: OverTypeInstance) => void;
+  onKeydown?: (event: KeyboardEvent, instance: OverTypeInstance) => void;
 }
 
-interface ThemeObject {
-  [key: string]: string;
+// Interface for constructor that returns array
+export interface OverTypeConstructor {
+  new(target: string | Element | NodeList | Element[], options?: Options): OverTypeInstance[];
+  // Static members
+  instances: WeakMap<Element, OverTypeInstance>;
+  stylesInjected: boolean;
+  globalListenersInitialized: boolean;
+  instanceCount: number;
+  currentTheme: Theme;
+  themes: {
+    solar: Theme;
+    cave: Theme;
+  };
+  MarkdownParser: any;
+  ShortcutsManager: any;
+  init(target: string | Element | NodeList | Element[], options?: Options): OverTypeInstance[];
+  getInstance(element: Element): OverTypeInstance | null;
+  destroyAll(): void;
+  injectStyles(force?: boolean): void;
+  setTheme(theme: string | Theme, customColors?: Partial<Theme['colors']>): void;
+  initGlobalListeners(): void;
+  getTheme(name: string): Theme;
 }
 
-class OverType {
-  constructor(
-    target: string | Element | NodeList | Element[],
-    options?: OverTypeOptions
-  );
+export interface OverTypeInstance {
+  // Public properties
+  container: HTMLElement;
+  wrapper: HTMLElement;
+  textarea: HTMLTextAreaElement;
+  preview: HTMLElement;
+  statsBar?: HTMLElement;
+  toolbar?: any; // Toolbar instance
+  shortcuts?: any; // ShortcutsManager instance
+  linkTooltip?: any; // LinkTooltip instance
+  options: Options;
+  initialized: boolean;
+  instanceId: number;
+  element: Element;
 
+  // Public methods
   getValue(): string;
   setValue(value: string): void;
-  getRenderedHTML(processContent?: boolean): string;
-  getPreviewHTML(): string;
-  static setTheme(theme: string | ThemeObject): void;
+  getStats(): Stats;
+  getContainer(): HTMLElement;
+  focus(): void;
+  blur(): void;
+  destroy(): void;
+  isInitialized(): boolean;
+  reinit(options: Options): void;
   showStats(show: boolean): void;
-  showPlainTextarea(show: boolean): void;
-  showPreviewMode(show: boolean): void;
-
-  static init(selector: string, options?: OverTypeOptions): OverType[];
+  setTheme(theme: string | Theme): void;
+  updatePreview(): void;
 }
 
-export = OverType;
+// Declare the constructor as a constant with proper typing
+declare const OverType: OverTypeConstructor;
+
+// Export the instance type under a different name for clarity
+export type OverType = OverTypeInstance;
+
+// Module exports - default export is the constructor
+export default OverType;