next approach

.eslintrc.json

@@ -11,7 +11,6 @@
       "src/browser/tsconfig.json",
       "src/common/tsconfig.json",
       "src/headless/tsconfig.json",
-      "src/shared/tsconfig.json",
       "src/vs/tsconfig.json",
       "test/benchmark/tsconfig.json",
       "test/playwright/tsconfig.json",

addons/addon-progress/src/ProgressAddon.ts

@@ -3,17 +3,9 @@
  * @license MIT
  */
 
-import { Terminal, ITerminalAddon, IDisposable, EmitterCtorType, IEmitter, IEvent } from '@xterm/xterm';
+import { Terminal, ITerminalAddon, IDisposable, IEmitter, IEvent, ISharedExports } from '@xterm/xterm';
 import type { ProgressAddon as IProgressApi, IProgressState } from '@xterm/addon-progress';
 
-// to use impl parts:
-
-// in 3rd party addons
-// import { EmitterAddon } from '@xterm/xterm';
-
-// in xtermjs repo addons
-import { EmitterAddon } from 'shared/shared';
-
 
 const enum ProgressType {
   REMOVE = 0,
@@ -40,16 +32,15 @@ function toInt(s: string): number {
 }
 
 
-export class ProgressAddon extends EmitterAddon implements ITerminalAddon, IProgressApi {
+export class ProgressAddon implements ITerminalAddon, IProgressApi {
   private _seqHandler: IDisposable | undefined;
   private _st: ProgressType = ProgressType.REMOVE;
   private _pr = 0;
   private _onChange: IEmitter<IProgressState>;
   public onChange: IEvent<IProgressState>;
 
-  constructor(protected readonly _emitterCtor: EmitterCtorType) {
-    super(_emitterCtor);
-    this._onChange = new this._emitterCtor<IProgressState>();
+  constructor(sharedExports: ISharedExports) {
+    this._onChange = new sharedExports.Emitter<IProgressState>();
     this.onChange = this._onChange.event;
   }
 

addons/addon-progress/src/tsconfig.json

@@ -22,9 +22,6 @@
       "vs/*": [
         "../../../src/vs/*"
       ],
-      "shared/*": [
-        "../../../src/shared/*"
-      ],
       "@xterm/addon-progress": [
         "../typings/addon-progress.d.ts"
       ]
@@ -40,9 +37,6 @@
     },
     {
       "path": "../../../src/vs"
-    },
-    {
-      "path": "../../../src/shared"
     }
   ]
 }

addons/addon-progress/test/ProgressAddon.test.ts

@@ -23,7 +23,7 @@ test.describe('ProgressAddon', () => {
       window.progressStack = [];
       window.term.reset();
       window.progressAddon?.dispose();
-      window.progressAddon = new ProgressAddon(emitterCtor);
+      window.progressAddon = new ProgressAddon(sharedExports);
       window.term.loadAddon(window.progressAddon);
       window.progressAddon.onChange(progress => window.progressStack.push(progress));
     `);

addons/addon-progress/typings/addon-progress.d.ts

@@ -3,20 +3,20 @@
  * @license MIT
  */
 
-import { Terminal, ITerminalAddon, IDisposable, IEvent, EmitterCtorType } from '@xterm/xterm';
-import { EmitterAddon } from 'shared/shared';
+import { Terminal, ITerminalAddon, IDisposable, IEvent, ISharedExports } from '@xterm/xterm';
+
 
 declare module '@xterm/addon-progress' {
   /**
    * An xterm.js addon that provides an interface for ConEmu's progress
    * sequence.
    */
-  export class ProgressAddon extends EmitterAddon implements ITerminalAddon, IDisposable {
+  export class ProgressAddon implements ITerminalAddon, IDisposable {
 
     /**
      * Creates a new progress addon
      */
-    constructor(_emitterCtor: EmitterCtorType);
+    constructor(sharedExports: ISharedExports);
 
     /**
      * Activates the addon

addons/addon-progress/webpack.config.js

@@ -28,7 +28,6 @@ module.exports = {
       common: path.resolve('../../out/common'),
       browser: path.resolve('../../out/browser'),
       vs: path.resolve('../../out/vs'),
-      shared: path.resolve('../../out/shared')
     }
   },
   output: {

bin/esbuild.mjs

@@ -176,7 +176,6 @@ if (config.addon) {
       'src/browser/**/*.ts',
       'src/common/**/*.ts',
       'src/headless/**/*.ts',
-      'src/shared/**/*.ts',
       'src/vs/base/**/*.ts',
       'src/vs/patches/**/*.ts'
     ],

demo/client.ts

@@ -16,7 +16,7 @@ if ('WebAssembly' in window) {
   ImageAddon = imageAddon.ImageAddon;
 }
 
-import { Terminal, ITerminalOptions, type IDisposable, type ITheme, emitterCtor } from '@xterm/xterm';
+import { Terminal, ITerminalOptions, type IDisposable, type ITheme, sharedExports, ISharedExports } from '@xterm/xterm';
 import { AttachAddon } from '@xterm/addon-attach';
 import { ClipboardAddon } from '@xterm/addon-clipboard';
 import { FitAddon } from '@xterm/addon-fit';
@@ -32,6 +32,7 @@ import { UnicodeGraphemesAddon } from '@xterm/addon-unicode-graphemes';
 export interface IWindowWithTerminal extends Window {
   term: typeof Terminal;
   Terminal: typeof Terminal;
+  sharedExports: ISharedExports;
   AttachAddon?: typeof AttachAddon; // eslint-disable-line @typescript-eslint/naming-convention
   ClipboardAddon?: typeof ClipboardAddon; // eslint-disable-line @typescript-eslint/naming-convention
   FitAddon?: typeof FitAddon; // eslint-disable-line @typescript-eslint/naming-convention
@@ -44,8 +45,6 @@ export interface IWindowWithTerminal extends Window {
   Unicode11Addon?: typeof Unicode11Addon; // eslint-disable-line @typescript-eslint/naming-convention
   UnicodeGraphemesAddon?: typeof UnicodeGraphemesAddon; // eslint-disable-line @typescript-eslint/naming-convention
   LigaturesAddon?: typeof LigaturesAddon; // eslint-disable-line @typescript-eslint/naming-convention
-
-  emitterCtor?: typeof emitterCtor;
 }
 declare let window: IWindowWithTerminal;
 
@@ -216,6 +215,7 @@ const createNewWindowButtonHandler: () => void = () => {
 
 if (document.location.pathname === '/test') {
   window.Terminal = Terminal;
+  window.sharedExports = sharedExports;
   window.AttachAddon = AttachAddon;
   window.ClipboardAddon = ClipboardAddon;
   window.FitAddon = FitAddon;
@@ -228,8 +228,6 @@ if (document.location.pathname === '/test') {
   window.LigaturesAddon = LigaturesAddon;
   window.WebLinksAddon = WebLinksAddon;
   window.WebglAddon = WebglAddon;
-
-  window.emitterCtor = emitterCtor;
 } else {
   createTerminal();
   document.getElementById('dispose').addEventListener('click', disposeRecreateButtonHandler);
@@ -283,7 +281,8 @@ function createTerminal(): void {
   addons.serialize.instance = new SerializeAddon();
   addons.fit.instance = new FitAddon();
   addons.image.instance = new ImageAddon();
-  addons.progress.instance = new ProgressAddon(emitterCtor);
+  //addons.progress.instance = new ProgressAddon(Terminal as unknown as IXtermSharedImports);
+  addons.progress.instance = new ProgressAddon(sharedExports);
   addons.unicodeGraphemes.instance = new UnicodeGraphemesAddon();
   addons.clipboard.instance = new ClipboardAddon();
   try {  // try to start with webgl renderer (might throw on older safari/webkit)
@@ -664,6 +663,7 @@ function initAddons(term: Terminal): void {
       }
       if (checkbox.checked) {
         // HACK: Manually remove addons that cannot be changes
+        // FIXME: re-enable this once done with the sharedExports
         //addon.instance = new (addon as IDemoAddon<Exclude<AddonType, 'attach'>>).ctor();
         try {
           term.loadAddon(addon.instance);

src/browser/public/Terminal.ts

@@ -6,14 +6,26 @@
 import * as Strings from 'browser/LocalizableStrings';
 import { CoreBrowserTerminal as TerminalCore } from 'browser/CoreBrowserTerminal';
 import { IBufferRange, ITerminal } from 'browser/Types';
-import { Disposable } from 'vs/base/common/lifecycle';
+import { Disposable, DisposableStore, toDisposable } from 'vs/base/common/lifecycle';
 import { ITerminalOptions } from 'common/Types';
 import { AddonManager } from 'common/public/AddonManager';
 import { BufferNamespaceApi } from 'common/public/BufferNamespaceApi';
 import { ParserApi } from 'common/public/ParserApi';
 import { UnicodeApi } from 'common/public/UnicodeApi';
-import { IBufferNamespace as IBufferNamespaceApi, IDecoration, IDecorationOptions, IDisposable, ILinkProvider, ILocalizableStrings, IMarker, IModes, IParser, ITerminalAddon, Terminal as ITerminalApi, ITerminalInitOnlyOptions, IUnicodeHandling } from '@xterm/xterm';
-import { type Event } from 'vs/base/common/event';
+import { IBufferNamespace as IBufferNamespaceApi, IDecoration, IDecorationOptions, IDisposable, ILinkProvider, ILocalizableStrings, IMarker, IModes, IParser, ITerminalAddon, Terminal as ITerminalApi, ITerminalInitOnlyOptions, IUnicodeHandling, ISharedExports } from '@xterm/xterm';
+import { type Event, Emitter } from 'vs/base/common/event';
+
+
+/**
+ * EXPERIMENTAL:
+ * Expose certain building blocks on the module to be used at runtime in addons.
+ */
+export const sharedExports: ISharedExports = {
+  DisposableStore,
+  Emitter,
+  toDisposable
+};
+
 
 /**
  * The set of options that only have an effect when set in the Terminal constructor.
@@ -272,17 +284,3 @@ export class Terminal extends Disposable implements ITerminalApi {
     }
   }
 }
-
-
-/**
- * Expose often needed vs/* parts in addons.
- * Exposed statically on the xterm package,
- * so they can be used on addon ctors already.
- */
-export {
-  DisposableAddon,
-  EmitterAddon,
-  DisposableEmitterAddon
-} from 'shared/shared';
-export { DisposableStore as disposableStoreCtor, toDisposable } from 'vs/base/common/lifecycle';
-export { Emitter as emitterCtor } from 'vs/base/common/event';

src/browser/tsconfig.json

@@ -13,8 +13,7 @@
     "baseUrl": "..",
     "paths": {
       "common/*": [ "./common/*" ],
-      "vs/*": [ "./vs/*" ],
-      "shared/*": [ "./shared/*" ],
+      "vs/*": [ "./vs/*" ]
     }
   },
   "include": [
@@ -23,7 +22,6 @@
   ],
   "references": [
     { "path": "../common" },
-    { "path": "../vs" },
-    { "path": "../shared" },
+    { "path": "../vs" }
   ]
 }

src/common/shared/AddonDisposable.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2024 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+import { IDisposable, IDisposableStore, ISharedExports } from '@xterm/xterm';
+
+
+export class AddonDisposable implements IDisposable {
+  protected readonly _store: IDisposableStore;
+
+  constructor(sharedExports: ISharedExports) {
+    this._store = new sharedExports.DisposableStore();
+  }
+
+  public dispose(): void {
+    this._store.dispose();
+  }
+}

src/headless/public/Terminal.ts

@@ -6,12 +6,25 @@
 import { BufferNamespaceApi } from 'common/public/BufferNamespaceApi';
 import { ParserApi } from 'common/public/ParserApi';
 import { UnicodeApi } from 'common/public/UnicodeApi';
-import { IBufferNamespace as IBufferNamespaceApi, IMarker, IModes, IParser, ITerminalAddon, ITerminalInitOnlyOptions, IUnicodeHandling, Terminal as ITerminalApi } from '@xterm/headless';
+import { IBufferNamespace as IBufferNamespaceApi, IMarker, IModes, IParser, ITerminalAddon, ITerminalInitOnlyOptions, IUnicodeHandling, Terminal as ITerminalApi, ISharedExports } from '@xterm/headless';
 import { Terminal as TerminalCore } from 'headless/Terminal';
 import { AddonManager } from 'common/public/AddonManager';
 import { ITerminalOptions } from 'common/Types';
-import { Disposable } from 'vs/base/common/lifecycle';
-import type { Event } from 'vs/base/common/event';
+import { Disposable, DisposableStore, toDisposable } from 'vs/base/common/lifecycle';
+import { type Event, Emitter } from 'vs/base/common/event';
+
+
+/**
+ * EXPERIMENTAL:
+ * Expose certain building blocks on the module to be used at runtime in addons.
+ */
+export const sharedExports: ISharedExports = {
+  DisposableStore,
+  Emitter,
+  toDisposable
+};
+
+
 /**
  * The set of options that only have an effect when set in the Terminal constructor.
  */

typings/xterm-headless.d.ts

@@ -1358,4 +1358,31 @@ declare module '@xterm/headless' {
      */
     readonly wraparoundMode: boolean;
   }
+
+  /**
+   * EXPERIMENTAL:
+   * Module exposure of certain building blocks to be used at runtime in addons.
+   */
+    export interface ISharedExports {
+      readonly DisposableStore: new() => IDisposableStore;
+      readonly Emitter: new<T>() => IEmitter<T>;
+      readonly toDisposable: (fn: () => void) => IDisposable;
+    }
+
+    export const sharedExports: ISharedExports;
+
+    // FIXME: @Tyriar - plz have a look at the following interfaces and
+    // to what degree those should be exposed or get stripped down
+    export interface IEmitter<T> extends IDisposable {
+      event: IEvent<T>;
+      fire(event: T): void;
+      hasListeners(): boolean;
+    }
+    export interface IDisposableStore extends IDisposable {
+      isDisposed: boolean;
+      clear(): void;
+      add<T extends IDisposable>(o: T): T;
+      delete<T extends IDisposable>(o: T): void;
+      deleteAndLeak<T extends IDisposable>(o: T): void;
+    }
 }