jupyterpack 0.5.1 → 0.5.3

package/README.md

@@ -7,7 +7,8 @@
 
 ## Features
 
-- **Python Web Apps**: Serve Python web applications directly in the browser using JupyterLite's in-browser Python kernel. `jupyterpack` currently supports Dash and Streamlit.
+- **Python Web Apps**: Serve Python web applications directly in the browser using JupyterLite's in-browser Python kernel. `jupyterpack` currently supports Dash, Streamlit and Shiny for Python. You can also use `jupyterpack` to serve any `asgi` or `wsgi` Python web application.
+  .
 - **JavaScript Web Apps**: Bundle and serve JavaScript web applications using in-browser bundlers.
 
 ![Image](https://github.com/user-attachments/assets/22849fe8-199f-4d9f-ad45-055bccf88bad)
@@ -46,7 +47,90 @@ the `app.spk` is the entry point of your React app, it should contain the follow
 }
 ```
 
-Double clicking the `spk` file to open the web app as a tab of JupyterLab.
+Double-clicking the `spk` file to open the web app as a tab of JupyterLab.
+
+## `.spk` — Jupyter Pack File Format
+
+A **`.spk`** file describes how an application should be loaded, executed, and rendered in JupyterLite and JupyterLab.  
+It defines the **entry point**, **framework**, optional **dependencies**, and runtime **metadata**, allowing reproducible execution across environments.
+
+The file is expressed in **JSON**.
+
+### Basic Structure
+
+```typescript
+interface IJupyterPackFileFormat {
+  entry: string;
+  framework: JupyterPackFramework;
+  name?: string;
+  metadata?: {
+    autoreload?: boolean;
+  };
+  rootUrl?: string;
+  dependencies?: IDependencies;
+  disableDependencies?: boolean;
+}
+```
+
+- `entry` (required): Path to the main entry file of the application. For examples:
+  - _"app.py"_
+  - _"/index.html"_
+  - _"dashboard/index.py"_
+
+  The path is resolved relative to the .spk file location.
+
+- `framework` (required): The framework used to run the application. Supported frameworks are:
+
+  | Value       | Description                      |
+  | ----------- | -------------------------------- |
+  | `react`     | React-based frontend application |
+  | `dash`      | Plotly Dash application          |
+  | `streamlit` | Streamlit application            |
+  | `tornado`   | Tornado web application          |
+  | `shiny`     | Shiny application (Python)       |
+  | `starlette` | Starlette ASGI application       |
+
+- `name` (optional): The name of the application. If not provided, the name will be the name of the .spk file.
+
+- `metadata` (optional): Additional metadata for the application.
+  - `autoreload`: Enables automatic reload when source files change.
+
+- `rootUrl` (optional): The root URL of the web application. Default is `/`
+
+- `dependencies` (optional): The dependencies of the web application. It will be merged with the default dependencies of the selected framework
+  - `mamba`: Emscripten-forge packages
+  - `pip`: PYPI packages
+    Example:
+    ```typescript
+    dependencies: {
+      mamba: ['numpy, scipy'];
+      pip: ['plotly'];
+    }
+    ```
+
+  You only need to specify the dependencies of the application, the required dependencies of the framework will be automatically added.
+
+- `disableDependencies` (optional): Disable entirely the dependency installation. This is useful when dependencies are already provided by the environment. Default is `false`.
+
+### Full example
+
+```json
+{
+  "name": "Sales Dashboard",
+  "entry": "app.py",
+  "framework": "streamlit",
+  "rootUrl": "/",
+  "metadata": {
+    "autoreload": true
+  },
+  "dependencies": {
+    "mamba": ["numpy", "pandas"],
+    "pip": []
+  }
+}
+```
+
+## Framework-specific configurations
 
 ### Dash application
 
@@ -68,7 +152,27 @@ the `app.spk` is the entry point of your Dash app, it should contain the followi
 }
 ```
 
-For the Dash code, you need to define your Dash app variable as `app` and do not call `app.run_server` directly, `jupyterpack` will handle the server for you. Just as the case of React app, double clicking the spk file will open the Dash app in a new JupyterLab tab.
+For Dash applications, you must define your Dash instance as a variable named `app`.  
+Do **not** call `app.run_server()` yourself — `jupyterpack` is responsible for starting and managing the server lifecycle.
+
+As with React applications, double-clicking the `.spk` file will open the Dash app in a new JupyterLab tab.
+
+### Streamlit application
+
+Streamlit applications follow a similar structure to Dash apps.
+Write your code as a standard Streamlit application and do **not** start the server manually — `jupyterpack` will handle execution and serving automatically.
+
+Opening the `.spk` file will launch the Streamlit app in a new JupyterLab tab.
+
+### Shiny application
+
+Shiny applications also follow a structure similar to Dash apps.  
+`jupyterpack` supports both **Shiny Express** and **Shiny Core** applications.
+
+- **Shiny Express**: no special requirements.
+- **Shiny Core**: the application instance must be assigned to a variable named `app`.
+
+In both cases, the server is managed by `jupyterpack`, and opening the `.spk` file will launch the app in JupyterLab.
 
 ## Try it online!
 

package/lib/pythonServer/baseServer.d.ts

@@ -1,5 +1,5 @@
+import { IBasePythonServer, IDependencies, IDict, IKernelExecutor, IPythonServerInitOptions, JupyterPackFramework } from '../type';
 import { KernelExecutor } from './kernelExecutor';
-import { IDict, IBasePythonServer, IKernelExecutor, JupyterPackFramework } from '../type';
 export declare abstract class BasePythonServer implements IBasePythonServer {
     constructor(options: KernelExecutor.IOptions);
     abstract reloadPythonServer(options: {
@@ -9,12 +9,7 @@ export declare abstract class BasePythonServer implements IBasePythonServer {
     get isDisposed(): boolean;
     get kernelExecutor(): IKernelExecutor;
     dispose(): void;
-    init(options: {
-        entryPath?: string;
-        initCode?: string;
-        instanceId: string;
-        kernelClientId: string;
-    }): Promise<void>;
+    init(options: IPythonServerInitOptions): Promise<void>;
     disposePythonServer(): Promise<void>;
     getResponseFunctionFactory(options: {
         urlPath: string;
@@ -69,6 +64,7 @@ export declare abstract class BasePythonServer implements IBasePythonServer {
         kernelClientId: string;
         framework: JupyterPackFramework;
     }): string;
+    protected mergeDependencies(spkDeps?: IDependencies, defaultDeps?: IDependencies): IDependencies | undefined;
     protected _baseUrl: string | undefined;
     protected readonly _openedWebsockets: {
         instanceId: string;

package/lib/pythonServer/baseServer.js

@@ -1,7 +1,7 @@
-import { KernelExecutor } from './kernelExecutor';
-import websocketPatch from '../websocket/websocket.js?raw';
 import { PageConfig, URLExt } from '@jupyterlab/coreutils';
 import { arrayBufferToBase64, base64ToArrayBuffer, base64ToString, isBinaryContentType, stringOrNone } from '../tools';
+import websocketPatch from '../websocket/websocket.js?raw';
+import { KernelExecutor } from './kernelExecutor';
 export class BasePythonServer {
     constructor(options) {
         this._openedWebsockets = [];
@@ -33,6 +33,27 @@ export class BasePythonServer {
     patch_all()
     `;
         await this._kernelExecutor.executeCode({ code: patchCode });
+        if (!options.disableDependencies) {
+            const { dependencies } = options;
+            if (dependencies === null || dependencies === void 0 ? void 0 : dependencies.mamba) {
+                const mambaDeps = `
+      %mamba install ${dependencies.mamba.join(' ')}
+      True
+      `;
+                await this.kernelExecutor.executeCode({
+                    code: mambaDeps
+                }, true);
+            }
+            if (dependencies === null || dependencies === void 0 ? void 0 : dependencies.pip) {
+                const pipDeps = `
+        %pip install ${dependencies.pip.join(' ')}
+        True
+        `;
+                await this.kernelExecutor.executeCode({
+                    code: pipDeps
+                }, true);
+            }
+        }
     }
     async disposePythonServer() {
         await this.kernelExecutor.executeCode({
@@ -138,4 +159,17 @@ export class BasePythonServer {
         this._baseUrl = baseURL;
         return baseURL;
     }
+    mergeDependencies(spkDeps, defaultDeps) {
+        var _a, _b, _c, _d;
+        if (!spkDeps) {
+            return defaultDeps;
+        }
+        if (!defaultDeps) {
+            return spkDeps;
+        }
+        const merged = {};
+        merged.mamba = [...((_a = spkDeps.mamba) !== null && _a !== void 0 ? _a : []), ...((_b = defaultDeps.mamba) !== null && _b !== void 0 ? _b : [])];
+        merged.pip = [...((_c = spkDeps.pip) !== null && _c !== void 0 ? _c : []), ...((_d = defaultDeps.pip) !== null && _d !== void 0 ? _d : [])];
+        return merged;
+    }
 }

package/lib/pythonServer/dash/dashServer.d.ts

@@ -1,10 +1,7 @@
+import { IPythonServerInitOptions } from '../../type';
 import { BasePythonServer } from '../baseServer';
 export declare class DashServer extends BasePythonServer {
-    init(options: {
-        initCode?: string;
-        instanceId: string;
-        kernelClientId: string;
-    }): Promise<void>;
+    init(options: IPythonServerInitOptions): Promise<void>;
     reloadPythonServer(options: {
         entryPath?: string;
         initCode?: string;

package/lib/pythonServer/dash/dashServer.js

@@ -1,8 +1,13 @@
 import { JupyterPackFramework } from '../../type';
 import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
 export class DashServer extends BasePythonServer {
     async init(options) {
-        await super.init(options);
+        const mergedOptions = {
+            ...options,
+            dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+        };
+        await super.init(mergedOptions);
         const { initCode, instanceId, kernelClientId } = options;
         const baseURL = this.buildBaseURL({
             instanceId,

package/lib/pythonServer/dash/deps.d.ts

@@ -0,0 +1,2 @@
+import { IDependencies } from '../../type';
+export declare const DEPENDENCIES: IDependencies;

package/lib/pythonServer/dash/deps.js

@@ -0,0 +1,4 @@
+export const DEPENDENCIES = {
+    mamba: ['dash', 'werkzeug>=2.2,<3.0'],
+    pip: []
+};

package/lib/pythonServer/shiny/deps.d.ts

@@ -0,0 +1,2 @@
+import { IDependencies } from '../../type';
+export declare const DEPENDENCIES: IDependencies;

package/lib/pythonServer/shiny/deps.js

@@ -0,0 +1,4 @@
+export const DEPENDENCIES = {
+    mamba: [],
+    pip: ['shiny', 'shinychat']
+};

package/lib/pythonServer/shiny/shinyServer.d.ts

@@ -1,11 +1,7 @@
+import { IPythonServerInitOptions } from '../../type';
 import { BasePythonServer } from '../baseServer';
 export declare class ShinyServer extends BasePythonServer {
-    init(options: {
-        entryPath?: string;
-        initCode?: string;
-        instanceId: string;
-        kernelClientId: string;
-    }): Promise<void>;
+    init(options: IPythonServerInitOptions): Promise<void>;
     disposePythonServer(): Promise<void>;
     reloadPythonServer(options: {
         entryPath?: string;

package/lib/pythonServer/shiny/shinyServer.js

@@ -1,8 +1,13 @@
 import { JupyterPackFramework } from '../../type';
 import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
 export class ShinyServer extends BasePythonServer {
     async init(options) {
-        await super.init(options);
+        const mergedOptions = {
+            ...options,
+            dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+        };
+        await super.init(mergedOptions);
         const { instanceId, kernelClientId, entryPath } = options;
         const baseURL = this.buildBaseURL({
             instanceId,

package/lib/pythonServer/streamlit/deps.d.ts

@@ -0,0 +1,2 @@
+import { IDependencies } from '../../type';
+export declare const DEPENDENCIES: IDependencies;

package/lib/pythonServer/streamlit/deps.js

@@ -0,0 +1,10 @@
+export const DEPENDENCIES = {
+    mamba: [
+        'pyarrow',
+        'altair',
+        'blinker>=1.5.0,<2',
+        'cachetools>=4.0,<7',
+        'protobuf'
+    ],
+    pip: ['streamlit==1.50.0']
+};

package/lib/pythonServer/streamlit/streamlitServer.d.ts

@@ -1,11 +1,7 @@
-import { TornadoServer } from '../tornado/tornadoServer';
-export declare class StreamlitServer extends TornadoServer {
-    init(options: {
-        entryPath?: string;
-        initCode?: string;
-        instanceId: string;
-        kernelClientId: string;
-    }): Promise<void>;
+import { IPythonServerInitOptions } from '../../type';
+import { BasePythonServer } from '../baseServer';
+export declare class StreamlitServer extends BasePythonServer {
+    init(options: IPythonServerInitOptions): Promise<void>;
     reloadPythonServer(options: {
         entryPath?: string;
         initCode?: string;

package/lib/pythonServer/streamlit/streamlitServer.js

@@ -1,7 +1,13 @@
 import { JupyterPackFramework } from '../../type';
-import { TornadoServer } from '../tornado/tornadoServer';
-export class StreamlitServer extends TornadoServer {
+import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
+export class StreamlitServer extends BasePythonServer {
     async init(options) {
+        const mergedOptions = {
+            ...options,
+            dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+        };
+        await super.init(mergedOptions);
         const { instanceId, kernelClientId, entryPath } = options;
         if (!entryPath) {
             throw new Error('Missing streamlit entry path, please check your SPK file');
@@ -12,8 +18,7 @@ export class StreamlitServer extends TornadoServer {
             framework: JupyterPackFramework.STREAMLIT
         });
         const patchCode = `
-    from jupyterpack.common import set_base_url_env, patch_tornado, patch_all
-    patch_all()
+    from jupyterpack.common import set_base_url_env, patch_tornado
     patch_tornado()
     set_base_url_env("${baseURL}")
     `;

package/lib/pythonWidget/pythonWidgetModel.js

@@ -109,6 +109,8 @@ export class PythonWidgetModel {
         await executor.init({
             initCode: entryContent.content,
             entryPath: spkContent.entry,
+            dependencies: spkContent.dependencies,
+            disableDependencies: spkContent.disableDependencies,
             ...data
         });
         const finish = new PromiseDelegate();

package/lib/type.d.ts

@@ -28,6 +28,8 @@ export interface IJupyterPackFileFormat {
         autoreload?: boolean;
     };
     rootUrl?: string;
+    dependencies?: IDependencies;
+    disableDependencies?: boolean;
 }
 export declare enum MessageAction {
     INIT = "INIT"
@@ -61,12 +63,7 @@ export interface IBasePythonServer extends IDisposable {
         wsUrl: string;
         message: string;
     }): Promise<void>;
-    init(options: {
-        entryPath?: string;
-        initCode?: string;
-        instanceId: string;
-        kernelClientId: string;
-    }): Promise<void>;
+    init(options: IPythonServerInitOptions): Promise<void>;
     disposePythonServer(): Promise<void>;
     reloadPythonServer(options: {
         entryPath?: string;
@@ -106,3 +103,15 @@ export interface IPythonWidgetModel extends IDisposable {
         error: string;
     }>;
 }
+export interface IDependencies {
+    mamba?: string[];
+    pip?: string[];
+}
+export interface IPythonServerInitOptions {
+    entryPath?: string;
+    initCode?: string;
+    instanceId: string;
+    kernelClientId: string;
+    dependencies?: IDependencies;
+    disableDependencies?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterpack",
-    "version": "0.5.1",
+    "version": "0.5.3",
     "description": "A JupyterLab extension for serving web app.",
     "keywords": [
         "jupyter",

package/src/pythonServer/baseServer.ts

@@ -1,12 +1,5 @@
-import { KernelExecutor } from './kernelExecutor';
-import websocketPatch from '../websocket/websocket.js?raw';
-import {
-  IDict,
-  IBasePythonServer,
-  IKernelExecutor,
-  JupyterPackFramework
-} from '../type';
 import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+
 import {
   arrayBufferToBase64,
   base64ToArrayBuffer,
@@ -14,6 +7,16 @@ import {
   isBinaryContentType,
   stringOrNone
 } from '../tools';
+import {
+  IBasePythonServer,
+  IDependencies,
+  IDict,
+  IKernelExecutor,
+  IPythonServerInitOptions,
+  JupyterPackFramework
+} from '../type';
+import websocketPatch from '../websocket/websocket.js?raw';
+import { KernelExecutor } from './kernelExecutor';
 
 export abstract class BasePythonServer implements IBasePythonServer {
   constructor(options: KernelExecutor.IOptions) {
@@ -45,17 +48,39 @@ export abstract class BasePythonServer implements IBasePythonServer {
       })
       .catch(console.error);
   }
-  async init(options: {
-    entryPath?: string;
-    initCode?: string;
-    instanceId: string;
-    kernelClientId: string;
-  }): Promise<void> {
+  async init(options: IPythonServerInitOptions): Promise<void> {
     const patchCode = `
     from jupyterpack.common import patch_all
     patch_all()
     `;
     await this._kernelExecutor.executeCode({ code: patchCode });
+    if (!options.disableDependencies) {
+      const { dependencies } = options;
+      if (dependencies?.mamba) {
+        const mambaDeps = `
+      %mamba install ${dependencies.mamba.join(' ')}
+      True
+      `;
+        await this.kernelExecutor.executeCode(
+          {
+            code: mambaDeps
+          },
+          true
+        );
+      }
+      if (dependencies?.pip) {
+        const pipDeps = `
+        %pip install ${dependencies.pip.join(' ')}
+        True
+        `;
+        await this.kernelExecutor.executeCode(
+          {
+            code: pipDeps
+          },
+          true
+        );
+      }
+    }
   }
 
   async disposePythonServer(): Promise<void> {
@@ -230,6 +255,21 @@ export abstract class BasePythonServer implements IBasePythonServer {
 
     return baseURL;
   }
+  protected mergeDependencies(
+    spkDeps?: IDependencies,
+    defaultDeps?: IDependencies
+  ): IDependencies | undefined {
+    if (!spkDeps) {
+      return defaultDeps;
+    }
+    if (!defaultDeps) {
+      return spkDeps;
+    }
+    const merged: IDependencies = {};
+    merged.mamba = [...(spkDeps.mamba ?? []), ...(defaultDeps.mamba ?? [])];
+    merged.pip = [...(spkDeps.pip ?? []), ...(defaultDeps.pip ?? [])];
+    return merged;
+  }
 
   protected _baseUrl: string | undefined;
   protected readonly _openedWebsockets: {

package/src/pythonServer/dash/dashServer.ts

@@ -1,13 +1,15 @@
-import { JupyterPackFramework } from '../../type';
+import { IPythonServerInitOptions, JupyterPackFramework } from '../../type';
 import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
 
 export class DashServer extends BasePythonServer {
-  async init(options: {
-    initCode?: string;
-    instanceId: string;
-    kernelClientId: string;
-  }) {
-    await super.init(options);
+  async init(options: IPythonServerInitOptions) {
+    const mergedOptions: IPythonServerInitOptions = {
+      ...options,
+      dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+    };
+    await super.init(mergedOptions);
+
     const { initCode, instanceId, kernelClientId } = options;
 
     const baseURL = this.buildBaseURL({

package/src/pythonServer/dash/deps.ts

@@ -0,0 +1,6 @@
+import { IDependencies } from '../../type';
+
+export const DEPENDENCIES: IDependencies = {
+  mamba: ['dash', 'werkzeug>=2.2,<3.0'],
+  pip: []
+};

package/src/pythonServer/shiny/deps.ts

@@ -0,0 +1,6 @@
+import { IDependencies } from '../../type';
+
+export const DEPENDENCIES: IDependencies = {
+  mamba: [],
+  pip: ['shiny', 'shinychat']
+};

package/src/pythonServer/shiny/shinyServer.ts

@@ -1,14 +1,15 @@
-import { JupyterPackFramework } from '../../type';
+import { IPythonServerInitOptions, JupyterPackFramework } from '../../type';
 import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
 
 export class ShinyServer extends BasePythonServer {
-  async init(options: {
-    entryPath?: string;
-    initCode?: string;
-    instanceId: string;
-    kernelClientId: string;
-  }) {
-    await super.init(options);
+  async init(options: IPythonServerInitOptions) {
+    const mergedOptions: IPythonServerInitOptions = {
+      ...options,
+      dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+    };
+    await super.init(mergedOptions);
+
     const { instanceId, kernelClientId, entryPath } = options;
     const baseURL = this.buildBaseURL({
       instanceId,

package/src/pythonServer/streamlit/deps.ts

@@ -0,0 +1,12 @@
+import { IDependencies } from '../../type';
+
+export const DEPENDENCIES: IDependencies = {
+  mamba: [
+    'pyarrow',
+    'altair',
+    'blinker>=1.5.0,<2',
+    'cachetools>=4.0,<7',
+    'protobuf'
+  ],
+  pip: ['streamlit==1.50.0']
+};

package/src/pythonServer/streamlit/streamlitServer.ts

@@ -1,13 +1,15 @@
-import { JupyterPackFramework } from '../../type';
-import { TornadoServer } from '../tornado/tornadoServer';
+import { IPythonServerInitOptions, JupyterPackFramework } from '../../type';
+import { BasePythonServer } from '../baseServer';
+import { DEPENDENCIES } from './deps';
+
+export class StreamlitServer extends BasePythonServer {
+  async init(options: IPythonServerInitOptions) {
+    const mergedOptions: IPythonServerInitOptions = {
+      ...options,
+      dependencies: this.mergeDependencies(options.dependencies, DEPENDENCIES)
+    };
+    await super.init(mergedOptions);
 
-export class StreamlitServer extends TornadoServer {
-  async init(options: {
-    entryPath?: string;
-    initCode?: string;
-    instanceId: string;
-    kernelClientId: string;
-  }) {
     const { instanceId, kernelClientId, entryPath } = options;
     if (!entryPath) {
       throw new Error(
@@ -21,8 +23,7 @@ export class StreamlitServer extends TornadoServer {
     });
 
     const patchCode = `
-    from jupyterpack.common import set_base_url_env, patch_tornado, patch_all
-    patch_all()
+    from jupyterpack.common import set_base_url_env, patch_tornado
     patch_tornado()
     set_base_url_env("${baseURL}")
     `;

package/src/pythonWidget/pythonWidgetModel.ts

@@ -135,9 +135,12 @@ export class PythonWidgetModel implements IPythonWidgetModel {
       sessionConnection: this._sessionConnection
     }));
     const data = await this._connectionManager.registerConnection(executor);
+
     await executor.init({
       initCode: entryContent.content,
       entryPath: spkContent.entry,
+      dependencies: spkContent.dependencies,
+      disableDependencies: spkContent.disableDependencies,
       ...data
     });
     const finish = new PromiseDelegate<void>();

package/src/type.ts

@@ -38,6 +38,8 @@ export interface IJupyterPackFileFormat {
     autoreload?: boolean;
   };
   rootUrl?: string;
+  dependencies?: IDependencies;
+  disableDependencies?: boolean;
 }
 
 export enum MessageAction {
@@ -78,12 +80,7 @@ export interface IBasePythonServer extends IDisposable {
     wsUrl: string;
     message: string;
   }): Promise<void>;
-  init(options: {
-    entryPath?: string;
-    initCode?: string;
-    instanceId: string;
-    kernelClientId: string;
-  }): Promise<void>;
+  init(options: IPythonServerInitOptions): Promise<void>;
   disposePythonServer(): Promise<void>;
   reloadPythonServer(options: {
     entryPath?: string;
@@ -125,3 +122,17 @@ export interface IPythonWidgetModel extends IDisposable {
     | { success: false; error: string }
   >;
 }
+
+export interface IDependencies {
+  mamba?: string[];
+  pip?: string[];
+}
+
+export interface IPythonServerInitOptions {
+  entryPath?: string;
+  initCode?: string;
+  instanceId: string;
+  kernelClientId: string;
+  dependencies?: IDependencies;
+  disableDependencies?: boolean;
+}