🔢 print version numbers (#772)

Author: stevejpurves

.changeset/cyan-weeks-cheer.md

@@ -0,0 +1,8 @@
+---
+'thebe-react': patch
+'thebe': patch
+'thebe-core': patch
+'thebe-lite': patch
+---
+
+Version numbers are printed in debug messages to aid in debugging

.gitignore

@@ -23,4 +23,6 @@ junit.xml
 
 .turbo
 .ipynb_checkpoints
-.yalc/
+.yalc/
+
+packages/**/src/version.ts

packages/core/package.json

@@ -13,16 +13,17 @@
   "scripts": {
     "clean": "rm -rf dist",
     "prepublish": "npm run build",
+    "copy:version": "echo \"const version = '\"$npm_package_version\"';\nexport default version;\" > src/version.ts",
     "build:css": "node ./esbuild.css.js",
     "build:cjs": "tsc --project ./tsconfig.json --outDir ./dist/cjs",
     "build:esm": "tsc --project ./tsconfig.json --module ES2020 --outDir ./dist/esm",
     "build:bundle:dev": "webpack --config webpack.dev.js",
     "build:bundle": "webpack --config webpack.prod.js",
     "declarations": "tsc  --project ./tsconfig.json --declaration --emitDeclarationOnly --outDir dist/types",
-    "build:dev": "npm-run-all -l clean -p declarations build:cjs build:esm build:css build:bundle:dev",
-    "build": "npm-run-all -l clean -p declarations build:cjs build:esm build:css build:bundle",
+    "build:dev": "npm-run-all -l clean copy:version -p declarations build:cjs build:esm build:css build:bundle:dev",
+    "build": "npm-run-all -l clean copy:version -p declarations build:cjs build:esm build:css build:bundle",
     "build:watch": "concurrently 'npm run build:cjs -- -w' 'npm run copy:css' 'npm run build:bundle -- --watch'",
-    "dev": "npm run build:watch",
+    "dev": "npm run copy:version && npm run build:watch",
     "start": "webpack serve --open --config webpack.dev.js",
     "test:watch": "vitest",
     "test": "vitest run",

packages/core/src/index.ts

@@ -4,6 +4,7 @@ export { default as ThebeNotebook, CodeBlock } from './notebook';
 export { default as ThebeCodeCell } from './cell';
 export { default as ThebeMarkdownCell } from './markdown';
 export { default as PassiveCellRenderer } from './passive';
+export { default as version } from './version';
 
 export * from './options';
 export * from './events';
@@ -14,4 +15,5 @@ export * from './manager';
 export * from './rendermime';
 export * from './types';
 export * from './config';
+
 export { clearAllSavedSessions, clearSavedSession } from './sessions';

packages/core/src/thebe/api.ts

@@ -8,6 +8,7 @@ import { makeConfiguration } from '../options';
 import { makeRenderMimeRegistry } from '../rendermime';
 import * as coreModule from '../index';
 import type { IRenderMimeRegistry } from '@jupyterlab/rendermime';
+import version from '../version';
 
 export function connectToBinder(config: Config): ThebeServer {
   const server: ThebeServer = new ThebeServer(config);
@@ -55,7 +56,7 @@ export function setupNotebookFromIpynb(
 }
 
 export function setupThebeCore() {
-  console.debug(`thebe:api:setupThebeCore`, { coreModule });
+  console.debug(`thebe-core (v${version})`, { coreModule });
   window.thebeCore = Object.assign(window.thebeCore ?? {}, {
     module: coreModule,
     api: {
@@ -69,5 +70,6 @@ export function setupThebeCore() {
       setupNotebookFromBlocks,
       setupNotebookFromIpynb,
     },
+    version,
   });
 }

packages/core/src/thebe/entrypoint.ts

@@ -46,6 +46,7 @@ export type ThebeCore = typeof coreModule;
 export interface ThebeCoreGlobal {
   module: ThebeCore;
   api: JsApi;
+  version: string;
 }
 
 declare global {

packages/lite/package.json

@@ -10,12 +10,13 @@
   ],
   "scripts": {
     "clean": "rm -rf ./dist",
+    "copy:version": "echo \"const version = '\"$npm_package_version\"';\nexport default version;\" > src/version.ts",
     "build:bundle": "webpack --config webpack.config.cjs",
     "build:post:shuffle": "./bin/shufflePyolitePaths.sh",
     "build:post:contents": "./bin/stubContentsApi.js",
     "declarations": "tsc  --project ./tsconfig.json --declaration --emitDeclarationOnly --outDir dist/types",
-    "build": "npm-run-all -l clean -p build:bundle declarations",
-    "dev": "npm run build:bundle -- -w"
+    "build": "npm-run-all -l clean copy:version -p build:bundle declarations",
+    "dev": "npm run  copy:version && npm run build:bundle -- -w"
   },
   "repository": {
     "type": "git",

packages/lite/src/index.ts

@@ -1,5 +1,6 @@
 import { startJupyterLiteServer } from './jlite';
 import type { ThebeLiteGlobal } from './types';
+import version from './version';
 
 declare global {
   interface Window {
@@ -8,13 +9,13 @@ declare global {
 }
 
 function setupThebeLite() {
-  window.thebeLite = Object.assign(window.thebeLite ?? {}, { startJupyterLiteServer });
+  window.thebeLite = Object.assign(window.thebeLite ?? {}, { startJupyterLiteServer, version });
 }
 
 if (typeof window !== 'undefined') {
   console.debug('window is defined, setting up thebe-lite');
   setupThebeLite();
-  console.debug('window.thebeLite', window.thebeLite);
+  console.debug(`thebe-lite (v${window.thebeLite?.version ?? 0})`, window.thebeLite);
 }
 
 export * from './types';

packages/lite/src/types.ts

@@ -20,4 +20,5 @@ export type LiteServerConfig = {
 
 export interface ThebeLiteGlobal {
   startJupyterLiteServer: (config?: LiteServerConfig) => Promise<ServiceManager>;
+  version: string;
 }

packages/react/package.json

@@ -29,11 +29,12 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
+    "copy:version": "echo \"const version = '\"$npm_package_version\"';\nexport default version;\" > src/version.ts",
     "prepublish": "npm run build",
     "build:cjs": "tsc --project ./tsconfig.json --outDir ./dist",
     "declarations": "tsc  --project ./tsconfig.json --declaration --emitDeclarationOnly --outDir dist",
-    "build": "npm run declarations; npm run build:cjs",
-    "dev": "concurrently 'npm run declarations -- -w' 'npm run build:cjs -- -w'",
+    "build": "npm run copy:version; npm run declarations; npm run build:cjs",
+    "dev": "npm copy:version; concurrently 'npm run declarations -- -w' 'npm run build:cjs -- -w'",
     "test": "vitest run",
     "test:watch": "vitest"
   },