feat: add OpenEvent

Resolves #30 .

Author: ca-d

open-event.ts

@@ -0,0 +1,21 @@
+export type OpenDetail = {
+  doc: XMLDocument;
+  docName: string;
+};
+
+/** Represents the intent to open `doc` with filename `docName`. */
+export type OpenEvent = CustomEvent<OpenDetail>;
+
+export function newOpenEvent(doc: XMLDocument, docName: string): OpenEvent {
+  return new CustomEvent<OpenDetail>('oscd-open', {
+    bubbles: true,
+    composed: true,
+    detail: { doc, docName },
+  });
+}
+
+declare global {
+  interface ElementEventMap {
+    ['oscd-open']: OpenEvent;
+  }
+}

oscd-api.ts

@@ -28,3 +28,5 @@ export type {
   EditEventOptions,
   EditEventV2,
 } from './edit-event.js';
+
+export type { OpenDetail, OpenEvent } from './open-event.js';

utils.ts

@@ -20,3 +20,5 @@ export {
 export { convertEdit } from './convertEdit.js';
 
 export { newEditEventV2 } from './edit-event.js';
+
+export { newOpenEvent } from './open-event.js';