@jupyterlite/services 0.1.0 → 0.7.0-rc.1

package/lib/kernel/tokens.d.ts

@@ -0,0 +1,163 @@
+import type { Remote } from 'comlink';
+import type { IObservableMap } from '@jupyterlab/observables';
+import type { Kernel, KernelMessage, KernelSpec } from '@jupyterlab/services';
+import { Token } from '@lumino/coreutils';
+import type { IObservableDisposable } from '@lumino/disposable';
+import type { ISignal } from '@lumino/signaling';
+import type { KernelSpecs } from './kernelspecs';
+/**
+ * The kernel name of last resort.
+ */
+export declare const FALLBACK_KERNEL = "javascript";
+/**
+ * The token for the kernel client.
+ */
+export declare const IKernelClient: Token<IKernelClient>;
+/**
+ * An interface for the Kernels service.
+ */
+export interface IKernelClient extends Kernel.IKernelAPIClient {
+    /**
+     * Signal emitted when the kernels map changes
+     */
+    readonly changed: ISignal<IKernelClient, IObservableMap.IChangedArgs<IKernel>>;
+    /**
+     * Handle stdin request received from Service Worker.
+     */
+    handleStdin(inputRequest: KernelMessage.IInputRequestMsg): Promise<KernelMessage.IInputReplyMsg>;
+    /**
+     * Shut down all kernels.
+     */
+    shutdownAll: () => Promise<void>;
+}
+/**
+ * The token for the kernel spec client.
+ */
+export declare const IKernelSpecClient: Token<IKernelSpecClient>;
+/**
+ * An interface for the kernel spec client.
+ */
+export interface IKernelSpecClient extends KernelSpec.IKernelSpecAPIClient {
+}
+/**
+ * An interface for a kernel running in the browser.
+ */
+export interface IKernel extends IObservableDisposable {
+    /**
+     * The id of the server-side kernel.
+     */
+    readonly id: string;
+    /**
+     * The name of the server-side kernel.
+     */
+    readonly name: string;
+    /**
+     * The location in the virtual filesystem from which the kernel was started.
+     */
+    readonly location: string;
+    /**
+     * A promise that is fulfilled when the kernel is ready.
+     */
+    readonly ready: Promise<void>;
+    /**
+     * Handle an incoming message from the client.
+     *
+     * @param msg The message to handle
+     */
+    handleMessage(msg: KernelMessage.IMessage): Promise<void>;
+}
+/**
+ * A namespace for IKernel statics.
+ */
+export declare namespace IKernel {
+    /**
+     * The type for the send message function.
+     */
+    type SendMessage = (msg: KernelMessage.IMessage) => void;
+    /**
+     * The instantiation options for an IKernel.
+     */
+    interface IOptions {
+        /**
+         * The kernel id.
+         */
+        id: string;
+        /**
+         * The name of the kernel.
+         */
+        name: string;
+        /**
+         * The location in the virtual filesystem from which the kernel was started.
+         */
+        location: string;
+        /**
+         * The method to send messages back to the server.
+         */
+        sendMessage: SendMessage;
+    }
+}
+/**
+ * The token for the kernel spec service.
+ */
+export declare const IKernelSpecs: Token<IKernelSpecs>;
+/**
+ * The interface for the kernel specs service.
+ */
+export interface IKernelSpecs {
+    /**
+     * Get the kernel specs.
+     */
+    readonly specs: KernelSpec.ISpecModels | null;
+    /**
+     * Get the default kernel name.
+     */
+    readonly defaultKernelName: string;
+    /**
+     * Get the kernel factories for the current kernels.
+     */
+    readonly factories: KernelSpecs.KernelFactories;
+    /**
+     * Signal emitted when the specs change.
+     */
+    readonly changed: ISignal<IKernelSpecs, KernelSpec.ISpecModels | null>;
+    /**
+     * Register a new kernel spec
+     *
+     * @param options The kernel spec options.
+     */
+    register: (options: KernelSpecs.IKernelOptions) => void;
+}
+/**
+ * An interface for a comlink-based worker kernel
+ */
+export interface IWorkerKernel {
+    /**
+     * Handle any lazy setup activities.
+     */
+    initialize(options: IWorkerKernel.IOptions): Promise<void>;
+    execute(content: KernelMessage.IExecuteRequestMsg['content'], parent: any): Promise<KernelMessage.IExecuteReplyMsg['content']>;
+    complete(content: KernelMessage.ICompleteRequestMsg['content'], parent: any): Promise<KernelMessage.ICompleteReplyMsg['content']>;
+    inspect(content: KernelMessage.IInspectRequestMsg['content'], parent: any): Promise<KernelMessage.IInspectReplyMsg['content']>;
+    isComplete(content: KernelMessage.IIsCompleteRequestMsg['content'], parent: any): Promise<KernelMessage.IIsCompleteReplyMsg['content']>;
+    commInfo(content: KernelMessage.ICommInfoRequestMsg['content'], parent: any): Promise<KernelMessage.ICommInfoReplyMsg['content']>;
+    commOpen(content: KernelMessage.ICommOpenMsg, parent: any): Promise<void>;
+    commMsg(content: KernelMessage.ICommMsgMsg, parent: any): Promise<void>;
+    commClose(content: KernelMessage.ICommCloseMsg, parent: any): Promise<void>;
+    inputReply(content: KernelMessage.IInputReplyMsg['content'], parent: any): Promise<void>;
+}
+/**
+ * A namespace for worker kernels.
+ **/
+export declare namespace IWorkerKernel {
+    /**
+     * Common values likely to be required by all kernels.
+     */
+    interface IOptions {
+        /**
+         * The base URL of the kernel server.
+         */
+        baseUrl: string;
+    }
+}
+export interface IRemoteKernel extends Remote<IWorkerKernel> {
+}

package/lib/kernel/tokens.js

@@ -0,0 +1,20 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+import { Token } from '@lumino/coreutils';
+/**
+ * The kernel name of last resort.
+ */
+export const FALLBACK_KERNEL = 'javascript';
+/**
+ * The token for the kernel client.
+ */
+export const IKernelClient = new Token('@jupyterlite/services:IKernelClient');
+/**
+ * The token for the kernel spec client.
+ */
+export const IKernelSpecClient = new Token('@jupyterlite/services:IKernelSpecClient');
+/**
+ * The token for the kernel spec service.
+ */
+export const IKernelSpecs = new Token('@jupyterlite/services:IKernelSpecs');
+//# sourceMappingURL=tokens.js.map

package/lib/kernel/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/kernel/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAQ3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAQ1C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,KAAK,CACpC,qCAAqC,CACtC,CAAC;AAwBF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,KAAK,CACxC,yCAAyC,CAC1C,CAAC;AA0EF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,KAAK,CACnC,oCAAoC,CACrC,CAAC"}

package/lib/nbconvert/exporters.d.ts

@@ -0,0 +1,80 @@
+import type { Contents } from '@jupyterlab/services';
+import type { IExporter } from './tokens';
+/**
+ * Base class for notebook exporters.
+ */
+export declare abstract class BaseExporter implements IExporter {
+    /**
+     * The MIME type of the exported format.
+     */
+    abstract readonly mimeType: string;
+    /**
+     * Export a notebook to this format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    abstract export(model: Contents.IModel, path: string): Promise<void>;
+    /**
+     * Trigger a browser download of the exported content.
+     *
+     * @param content The content to download
+     * @param mimeType The MIME type of the content
+     * @param filename The filename for the download
+     */
+    protected triggerDownload(content: string, mimeType: string, filename: string): void;
+}
+/**
+ * Exporter for notebook format (.ipynb).
+ */
+export declare class NotebookExporter extends BaseExporter {
+    /**
+     * The MIME type of the exported format.
+     */
+    readonly mimeType = "application/x-ipynb+json";
+    /**
+     * Export a notebook to .ipynb format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    export(model: Contents.IModel, path: string): Promise<void>;
+}
+/**
+ * Exporter for executable script format.
+ */
+export declare class ScriptExporter extends BaseExporter {
+    /**
+     * The MIME type of the exported format.
+     */
+    readonly mimeType = "text/x-script";
+    /**
+     * Export a notebook to executable script format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    export(model: Contents.IModel, path: string): Promise<void>;
+    /**
+     * Convert a notebook to a script file.
+     *
+     * @param content The notebook content
+     * @returns The script content and file extension
+     */
+    private convertToScript;
+    /**
+     * Comment out lines based on the language.
+     *
+     * @param text The text to comment
+     * @param language The programming language
+     * @returns The commented text
+     */
+    private commentLines;
+    /**
+     * Get the comment character for a given language.
+     *
+     * @param language The programming language
+     * @returns The comment character(s) for that language
+     */
+    private getCommentChar;
+}

package/lib/nbconvert/exporters.js

@@ -0,0 +1,154 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+/**
+ * Base class for notebook exporters.
+ */
+export class BaseExporter {
+    /**
+     * Trigger a browser download of the exported content.
+     *
+     * @param content The content to download
+     * @param mimeType The MIME type of the content
+     * @param filename The filename for the download
+     */
+    triggerDownload(content, mimeType, filename) {
+        const element = document.createElement('a');
+        element.href = `data:${mimeType};charset=utf-8,${encodeURIComponent(content)}`;
+        element.download = filename;
+        document.body.appendChild(element);
+        element.click();
+        document.body.removeChild(element);
+    }
+}
+/**
+ * Exporter for notebook format (.ipynb).
+ */
+export class NotebookExporter extends BaseExporter {
+    constructor() {
+        super(...arguments);
+        /**
+         * The MIME type of the exported format.
+         */
+        this.mimeType = 'application/x-ipynb+json';
+    }
+    /**
+     * Export a notebook to .ipynb format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    async export(model, path) {
+        var _a;
+        const mime = (_a = model.mimetype) !== null && _a !== void 0 ? _a : 'application/json';
+        const content = JSON.stringify(model.content, null, 2);
+        this.triggerDownload(content, mime, path);
+    }
+}
+/**
+ * Exporter for executable script format.
+ */
+export class ScriptExporter extends BaseExporter {
+    constructor() {
+        super(...arguments);
+        /**
+         * The MIME type of the exported format.
+         */
+        this.mimeType = 'text/x-script';
+    }
+    /**
+     * Export a notebook to executable script format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    async export(model, path) {
+        const { content, extension } = this.convertToScript(model.content);
+        const filename = path.replace(/\.ipynb$/, extension);
+        this.triggerDownload(content, 'text/plain', filename);
+    }
+    /**
+     * Convert a notebook to a script file.
+     *
+     * @param content The notebook content
+     * @returns The script content and file extension
+     */
+    convertToScript(content) {
+        var _a;
+        // Get the language from the notebook metadata
+        const languageInfo = (_a = content.metadata) === null || _a === void 0 ? void 0 : _a.language_info;
+        const language = (languageInfo === null || languageInfo === void 0 ? void 0 : languageInfo.name) || 'python';
+        const fileExtension = (languageInfo === null || languageInfo === void 0 ? void 0 : languageInfo.file_extension) || '.py';
+        // Extract code cells and convert to script
+        const cells = content.cells || [];
+        const scriptLines = [];
+        for (const cell of cells) {
+            if (cell.cell_type === 'code') {
+                // Add code cell content
+                const source = Array.isArray(cell.source) ? cell.source.join('') : cell.source;
+                scriptLines.push(source);
+                // Add blank line between cells
+                scriptLines.push('');
+            }
+            else if (cell.cell_type === 'markdown' || cell.cell_type === 'raw') {
+                // Add markdown and raw cells as comments
+                const source = Array.isArray(cell.source) ? cell.source.join('') : cell.source;
+                const commentedSource = this.commentLines(source, language);
+                scriptLines.push(commentedSource);
+                // Add blank line between cells
+                scriptLines.push('');
+            }
+        }
+        return {
+            content: scriptLines.join('\n') + '\n',
+            extension: fileExtension,
+        };
+    }
+    /**
+     * Comment out lines based on the language.
+     *
+     * @param text The text to comment
+     * @param language The programming language
+     * @returns The commented text
+     */
+    commentLines(text, language) {
+        const lines = text.split('\n');
+        const commentChar = this.getCommentChar(language);
+        return lines.map((line) => `${commentChar} ${line}`).join('\n');
+    }
+    /**
+     * Get the comment character for a given language.
+     *
+     * @param language The programming language
+     * @returns The comment character(s) for that language
+     */
+    getCommentChar(language) {
+        // Map of languages to their comment characters
+        const commentMap = {
+            python: '#',
+            r: '#',
+            julia: '#',
+            ruby: '#',
+            bash: '#',
+            shell: '#',
+            perl: '#',
+            javascript: '//',
+            typescript: '//',
+            java: '//',
+            c: '//',
+            cpp: '//',
+            'c++': '//',
+            scala: '//',
+            go: '//',
+            rust: '//',
+            swift: '//',
+            kotlin: '//',
+            matlab: '%',
+            octave: '%',
+            lua: '--',
+            sql: '--',
+            haskell: '--',
+        };
+        return commentMap[language.toLowerCase()] || '#';
+    }
+}
+//# sourceMappingURL=exporters.js.map

package/lib/nbconvert/exporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.js","sourceRoot":"","sources":["../../src/nbconvert/exporters.ts"],"names":[],"mappings":"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"}

package/lib/nbconvert/index.d.ts

@@ -0,0 +1,3 @@
+export * from './exporters';
+export * from './manager';
+export * from './tokens';

package/lib/nbconvert/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+export * from './exporters';
+export * from './manager';
+export * from './tokens';
+//# sourceMappingURL=index.js.map

package/lib/nbconvert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nbconvert/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAE3D,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/lib/nbconvert/manager.d.ts

@@ -0,0 +1,67 @@
+import type { Contents, NbConvert } from '@jupyterlab/services';
+import { NbConvertManager } from '@jupyterlab/services';
+import type { IExporter, INbConvertExporters } from './tokens';
+/**
+ * Options for creating a LiteNbConvertManager.
+ */
+export interface ILiteNbConvertManagerOptions extends NbConvertManager.IOptions {
+    /**
+     * The contents manager.
+     */
+    contentsManager: Contents.IManager;
+    /**
+     * The exporter registry.
+     */
+    exporters: INbConvertExporters;
+}
+/**
+ * Custom NbConvert manager for JupyterLite with client-side export.
+ */
+export declare class LiteNbConvertManager extends NbConvertManager {
+    /**
+     * Construct a new LiteNbConvertManager.
+     *
+     * @param options The manager options
+     */
+    constructor(options: ILiteNbConvertManagerOptions);
+    /**
+     * Get the list of export formats available.
+     */
+    getExportFormats(): Promise<NbConvert.IExportFormats>;
+    /**
+     * Export a notebook to a given format.
+     *
+     * @param options The export options
+     */
+    exportAs(options: NbConvert.IExportOptions): Promise<void>;
+    private _contentsManager;
+    private _exporters;
+}
+/**
+ * Implementation of the exporter registry.
+ */
+export declare class Exporters implements INbConvertExporters {
+    /**
+     * Register a new exporter.
+     *
+     * @param format The export format name
+     * @param exporter The exporter instance
+     */
+    register(format: string, exporter: IExporter): void;
+    /**
+     * Get an exporter by format.
+     *
+     * @param format The export format name
+     * @returns The exporter or undefined if not found
+     */
+    get(format: string): IExporter | undefined;
+    /**
+     * Get all registered export formats.
+     *
+     * @returns A map of format names to their MIME types
+     */
+    getExportFormats(): Record<string, {
+        output_mimetype: string;
+    }>;
+    private _exporters;
+}

package/lib/nbconvert/manager.js

@@ -0,0 +1,77 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+import { NbConvertManager } from '@jupyterlab/services';
+/**
+ * Custom NbConvert manager for JupyterLite with client-side export.
+ */
+export class LiteNbConvertManager extends NbConvertManager {
+    /**
+     * Construct a new LiteNbConvertManager.
+     *
+     * @param options The manager options
+     */
+    constructor(options) {
+        super(options);
+        this._contentsManager = options.contentsManager;
+        this._exporters = options.exporters;
+    }
+    /**
+     * Get the list of export formats available.
+     */
+    async getExportFormats() {
+        return this._exporters.getExportFormats();
+    }
+    /**
+     * Export a notebook to a given format.
+     *
+     * @param options The export options
+     */
+    async exportAs(options) {
+        const { format, path } = options;
+        const model = await this._contentsManager.get(path, { content: true });
+        const exporter = this._exporters.get(format);
+        if (!exporter) {
+            throw new Error(`Unknown export format: ${format}`);
+        }
+        await exporter.export(model, path);
+    }
+}
+/**
+ * Implementation of the exporter registry.
+ */
+export class Exporters {
+    constructor() {
+        this._exporters = new Map();
+    }
+    /**
+     * Register a new exporter.
+     *
+     * @param format The export format name
+     * @param exporter The exporter instance
+     */
+    register(format, exporter) {
+        this._exporters.set(format, exporter);
+    }
+    /**
+     * Get an exporter by format.
+     *
+     * @param format The export format name
+     * @returns The exporter or undefined if not found
+     */
+    get(format) {
+        return this._exporters.get(format);
+    }
+    /**
+     * Get all registered export formats.
+     *
+     * @returns A map of format names to their MIME types
+     */
+    getExportFormats() {
+        const formats = {};
+        for (const [format, exporter] of this._exporters) {
+            formats[format] = { output_mimetype: exporter.mimeType };
+        }
+        return formats;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/lib/nbconvert/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/nbconvert/manager.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmBxD;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IACxD;;;;OAIG;IACH,YAAY,OAAqC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAiC;QAC9C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;CAIF;AAED;;GAEG;AACH,MAAM,OAAO,SAAS;IAAtB;QAoCU,eAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IACpD,CAAC;IApCC;;;;;OAKG;IACH,QAAQ,CAAC,MAAc,EAAE,QAAmB;QAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,MAAM,OAAO,GAAgD,EAAE,CAAC;QAEhE,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CAGF"}

package/lib/nbconvert/tokens.d.ts

@@ -0,0 +1,49 @@
+import { Token } from '@lumino/coreutils';
+import type { Contents } from '@jupyterlab/services';
+/**
+ * The token for the exporter registry.
+ */
+export declare const INbConvertExporters: Token<INbConvertExporters>;
+/**
+ * Interface for the exporter registry.
+ */
+export interface INbConvertExporters {
+    /**
+     * Register a new exporter.
+     *
+     * @param format The export format name
+     * @param exporter The exporter instance
+     */
+    register(format: string, exporter: IExporter): void;
+    /**
+     * Get an exporter by format.
+     *
+     * @param format The export format name
+     * @returns The exporter or undefined if not found
+     */
+    get(format: string): IExporter | undefined;
+    /**
+     * Get all registered export formats.
+     *
+     * @returns A map of format names to their MIME types
+     */
+    getExportFormats(): Record<string, {
+        output_mimetype: string;
+    }>;
+}
+/**
+ * Interface for a notebook exporter.
+ */
+export interface IExporter {
+    /**
+     * The MIME type of the exported format.
+     */
+    readonly mimeType: string;
+    /**
+     * Export a notebook to this format.
+     *
+     * @param model The notebook model to export
+     * @param path The path to the notebook
+     */
+    export(model: Contents.IModel, path: string): Promise<void>;
+}

package/lib/nbconvert/tokens.js

@@ -0,0 +1,8 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+import { Token } from '@lumino/coreutils';
+/**
+ * The token for the exporter registry.
+ */
+export const INbConvertExporters = new Token('@jupyterlite/services:INbConvertExporters', 'A service for managing notebook exporters in JupyterLite');
+//# sourceMappingURL=tokens.js.map

package/lib/nbconvert/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/nbconvert/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI1C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,KAAK,CAC1C,2CAA2C,EAC3C,0DAA0D,CAC3D,CAAC"}