markdown-komponents 0.2.0 → 0.3.0

package/{markdown-komponents.d.mts → markdown-komponents.d.ts}

@@ -8,6 +8,11 @@
 // base are silently dropped from the declaration. Patching that generator output turned out to be
 // more fragile than just declaring the (small, stable) consumer-facing surface directly.
 //
+// Plain `.d.ts`, not `.d.mts`: the `.d.mts` extension didn't exist before TypeScript 4.7 (2022), so
+// older TypeScript (e.g. 3.9, confirmed against a real consumer) can't find it via package.json's
+// "types" field at all. This file has no ESM-specific syntax in it, so a plain `.d.ts` describes the
+// same shape and works everywhere.
+//
 // Keep this in sync with the real Kotlin source under src/jsMain/kotlin — it is NOT derived from it
 // automatically. `@JsExport` in the Kotlin source is what makes these actually exist as runtime
 // bindings; this file only describes their shape to TypeScript.
@@ -79,7 +84,9 @@ export class MarkdownComponentsRenderer implements MarkdownRenderer {
  */
 export class TsStackMarkdownRenderer {
   constructor(delegate?: MarkdownRenderer);
-  protected readonly options: { escape?: (html: string, encode: boolean) => string };
+  // `encode` optional to match the real `@ts-stack/markdown` type
+  // (node_modules/@ts-stack/markdown/src/interfaces.d.ts) it's meant to reflect.
+  protected readonly options: { escape?: (html: string, encode?: boolean) => string };
   /** Also called directly by this library's fenced-code-with-explicit-id block rule. */
   codeWithAnchor(code: string, lang: string | null | undefined, id: string | null | undefined, escaped?: boolean | null): string;
   code(code: string, lang: string | null | undefined, escaped: boolean | null | undefined, meta: string | null | undefined): string;
@@ -121,7 +128,9 @@ export abstract class BaseMarkdownDocument extends HTMLElement {
   parser: (markdown: string) => string;
   markdown: string;
   toolbar: Element | null;
-  selectionRoot: Document;
+  // Document | ShadowRoot: a consumer setting this from inside a shadow-DOM component (the intended
+  // use — see getSelection() below) has a real ShadowRoot here, not a Document.
+  selectionRoot: Document | ShadowRoot;
   onLinkClick: ((url: string) => void) | null;
   autoNormalize: boolean;
   readonly currentSelection: Selection | null;
@@ -198,3 +207,14 @@ export class MarkdownParagraph extends HTMLElement {
   getMarkdown(): string;
   isEmpty(): boolean;
 }
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'markdown-document': MarkdownDocument;
+    'markdown-editor': MarkdownEditor;
+    'markdown-toolbar': MarkdownToolbar;
+    'markdown-toc': MarkdownToc;
+    'markdown-image': MarkdownImage;
+    'markdown-paragraph': MarkdownParagraph;
+  }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "markdown-komponents",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "main": "markdown-komponents.mjs",
-  "types": "markdown-komponents.d.mts",
+  "types": "markdown-komponents.d.ts",
   "devDependencies": {},
   "dependencies": {
     "highlight.js": "10.5.0",