@datalayer/core 0.0.3 → 0.0.5

package/lib/utils/Lazy.d.ts

@@ -1,4 +1,4 @@
-import { ComponentType } from "react";
+import { ComponentType } from 'react';
 export type PreloadableComponent<T extends ComponentType<any>> = T & {
     preload: () => Promise<void>;
 };

package/lib/utils/Lazy.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { createElement, forwardRef, lazy as reactLazy } from "react";
+import { createElement, forwardRef, lazy as reactLazy, } from 'react';
 export function lazyWithPreload(factory) {
     const LazyComponent = reactLazy(factory);
     let factoryPromise;
@@ -12,7 +12,7 @@ export function lazyWithPreload(factory) {
     });
     Component.preload = () => {
         if (!factoryPromise) {
-            factoryPromise = factory().then((module) => {
+            factoryPromise = factory().then(module => {
                 LoadedComponent = module.default;
             });
         }

package/lib/utils/Name.js

@@ -3,22 +3,24 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export const asDisplayName = (givenName, familyName) => {
-    return givenName ?
-        familyName ?
-            (givenName + ' ' + familyName) : givenName
-        :
-            familyName ?? '';
+    return givenName
+        ? familyName
+            ? givenName + ' ' + familyName
+            : givenName
+        : (familyName ?? '');
 };
 export const nameAsInitials = (name) => {
     return name
         .replace(/\s+/, ' ')
         .split(' ')
         .slice(0, 2)
-        .map((v) => v && v[0].toUpperCase())
+        .map(v => v && v[0].toUpperCase())
         .join('');
 };
 export const namesAsInitials = (firstName, lastName) => {
-    return ((firstName || ' ').charAt(0) + (lastName || ' ').charAt(0)).toLocaleUpperCase().trim();
+    return ((firstName || ' ').charAt(0) + (lastName || ' ').charAt(0))
+        .toLocaleUpperCase()
+        .trim();
 };
 /**
  * Convert first and last names to a friendly name.
@@ -30,5 +32,5 @@ export const toFriendlyName = (firstName, lastName) => {
     if (lastName) {
         return lastName;
     }
-    return "";
+    return '';
 };

package/lib/utils/Notebook.d.ts

@@ -6,7 +6,7 @@ import { JupyterLab } from '@jupyterlab/application';
  * @param name Notebook name
  * @param url Notebook content URL
  */
-export declare const createNotebook: ({ app, name, url, options }: {
+export declare const createNotebook: ({ app, name, url, options, }: {
     app: JupyterLab;
     name?: string;
     url?: string;

package/lib/utils/Notebook.js

@@ -9,7 +9,7 @@
  * @param name Notebook name
  * @param url Notebook content URL
  */
-export const createNotebook = async ({ app, name, url, options }) => {
+export const createNotebook = async ({ app, name, url, options, }) => {
     const notebook = await app.commands.execute('notebook:create-new', options);
     /*
     if (name) {
@@ -22,7 +22,7 @@ export const createNotebook = async ({ app, name, url, options }) => {
         const text = nbmodelText.replaceAll('\n', `
 `);
         notebook.context.model.fromJSON({
-            ...JSON.parse(text)
+            ...JSON.parse(text),
         });
     }
 };
@@ -32,6 +32,6 @@ export const createNotebookVariant = async (app, name, url) => {
     const nbmodel = await fetch(url);
     const text = (await nbmodel.text()).replaceAll('\\n', '');
     notebook.context.model.fromJSON({
-        ...JSON.parse(text)
+        ...JSON.parse(text),
     });
 };

package/lib/utils/Number.js

@@ -3,19 +3,23 @@
  * Distributed under the terms of the Modified BSD License.
  */
 const LOOKUP_VALUE_SYMBOL = [
-    { value: 1, symbol: "" },
-    { value: 1e3, symbol: "K" },
-    { value: 1e6, symbol: "M" },
-    { value: 1e9, symbol: "G" },
-    { value: 1e12, symbol: "T" },
-    { value: 1e15, symbol: "P" },
-    { value: 1e18, symbol: "E" },
+    { value: 1, symbol: '' },
+    { value: 1e3, symbol: 'K' },
+    { value: 1e6, symbol: 'M' },
+    { value: 1e9, symbol: 'G' },
+    { value: 1e12, symbol: 'T' },
+    { value: 1e15, symbol: 'P' },
+    { value: 1e18, symbol: 'E' },
 ];
 // https://stackoverflow.com/questions/9461621/format-a-number-as-2-5k-if-a-thousand-or-more-otherwise-900
 export function numberFormatter(num, digits = 1) {
     const rx = /\.0+$|(\.[0-9]*[1-9])0+$/;
-    const item = LOOKUP_VALUE_SYMBOL.slice().reverse().find(function (item) {
+    const item = LOOKUP_VALUE_SYMBOL.slice()
+        .reverse()
+        .find(function (item) {
         return num >= item.value;
     });
-    return item ? (num / item.value).toFixed(digits).replace(rx, "$1") + item.symbol : "0";
+    return item
+        ? (num / item.value).toFixed(digits).replace(rx, '$1') + item.symbol
+        : '0';
 }

package/lib/utils/Plots.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { getDate, getDaysInMonth, getMonth, isSameMonth, isSameYear } from 'date-fns';
+import { getDate, getDaysInMonth, getMonth, isSameMonth, isSameYear, } from 'date-fns';
 /**
  * Compute the data for plotting the usage histogram.
  *
@@ -26,7 +26,7 @@ export function createHistogram(usages, interval, range) {
                 ? c.credits
                 : ((end - start.getTime()) * c.burningRate) / 1000,
             // getDate is 1-based but getMonth is 0-based
-            category: interval === 0 ? getDate(start) - 1 : getMonth(start)
+            category: interval === 0 ? getDate(start) - 1 : getMonth(start),
         };
     })
         .reduce((agg, d) => {
@@ -49,8 +49,8 @@ export function createHistogram(usages, interval, range) {
                 'Sep',
                 'Oct',
                 'Nov',
-                'Dec'
+                'Dec',
             ],
-        y: credits
+        y: credits,
     };
 }

package/lib/utils/Screenshot.js

@@ -8,7 +8,7 @@ export const takeHTMLNodeScreenshot = async (node) => {
         width: node.getBoundingClientRect().width,
         height: node.getBoundingClientRect().height,
     });
-    return sc.then((canvas) => {
+    return sc.then(canvas => {
         const croppedCanvas = document.createElement('canvas');
         const croppedCanvasContext = croppedCanvas.getContext('2d');
         const top = 0;

package/lib/utils/Sleep.js

@@ -3,6 +3,6 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export const sleep = async (ms) => {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise(resolve => setTimeout(resolve, ms));
 };
 export default sleep;

package/lib/utils/Snapshot.js

@@ -2,13 +2,13 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { adjectives, animals, uniqueNamesGenerator } from 'unique-names-generator';
+import { adjectives, animals, uniqueNamesGenerator, } from 'unique-names-generator';
 /**
  * Kernel snapshot description configuration.
  */
 const KERNEL_SNAPSHOT_DESCRIPTION_CONFIGURATION = {
     dictionaries: [adjectives, animals],
-    separator: '-'
+    separator: '-',
 };
 /**
  * Create an unique human readable kernel snapshot name.

package/lib/utils/String.js

@@ -4,10 +4,10 @@
  */
 export const strip = (s, max = 50) => {
     if (!s) {
-        return "";
+        return '';
     }
     if (s.length > max) {
-        return s.substring(0, max) + "…";
+        return s.substring(0, max) + '…';
     }
     return s;
 };

package/lib/utils/Uri.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export const currentUri = () => {
-    return window.location.protocol + "//" + window.location.host;
+    return window.location.protocol + '//' + window.location.host;
 };
 // https://stackoverflow.com/questions/12168909/blob-from-dataurl
 export const dataURItoBlob = (dataURI) => {

package/lib/utils/WithSuspense.js

@@ -3,14 +3,11 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { Suspense } from "react";
-import { SkeletonBox } from "@primer/react/experimental";
+import { Suspense } from 'react';
+import { SkeletonBox } from '@primer/react/experimental';
 const Loading = (props) => {
     const { skeleton } = props;
-    return (skeleton ?
-        _jsx(_Fragment, { children: _jsx(SkeletonBox, { height: "100px" }) })
-        :
-            _jsx(_Fragment, {}));
+    return skeleton ? (_jsx(_Fragment, { children: _jsx(SkeletonBox, { height: "100px" }) })) : (_jsx(_Fragment, {}));
 };
 export const WithSuspense = (Component, preload = true, skeleton = false) => (props) => {
     if (preload) {

package/lib/utils/logger.d.ts

@@ -0,0 +1,16 @@
+declare class Logger {
+    private scope;
+    private isDevelopment;
+    constructor(scope: string);
+    private log;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+export declare function createLogger(scope: string): Logger;
+export declare const coreLogger: Logger;
+export declare const apiLogger: Logger;
+export declare const stateLogger: Logger;
+export declare const configLogger: Logger;
+export {};

package/lib/utils/logger.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+class Logger {
+    scope;
+    isDevelopment;
+    constructor(scope) {
+        this.scope = scope;
+        this.isDevelopment = process.env.NODE_ENV === 'development';
+    }
+    log(level, message, ...args) {
+        if (!this.isDevelopment && level === 'debug') {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${this.scope}] [${level.toUpperCase()}]`;
+        switch (level) {
+            case 'debug':
+                console.debug(prefix, message, ...args);
+                break;
+            case 'info':
+                console.info(prefix, message, ...args);
+                break;
+            case 'warn':
+                console.warn(prefix, message, ...args);
+                break;
+            case 'error':
+                console.error(prefix, message, ...args);
+                break;
+        }
+    }
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+}
+export function createLogger(scope) {
+    return new Logger(scope);
+}
+export const coreLogger = createLogger('core');
+export const apiLogger = createLogger('api');
+export const stateLogger = createLogger('state');
+export const configLogger = createLogger('config');

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@datalayer/core",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
+  "workspaces": [
+    ".",
+    "examples/*"
+  ],
   "author": {
     "name": "Datalayer",
     "email": "info@datalayer.io"
@@ -43,7 +47,20 @@
     "dev": "vite",
     "build": "gulp resources-to-lib && tsc -b && vite build",
     "build:lib": "gulp resources-to-lib && tsc -b",
-    "lint": "eslint .",
+    "build:nextjs": "npm run build --workspace=nextjs-notebook-example",
+    "build:electron": "npm run build --workspace=@datalayer/electron-example",
+    "build:examples": "npm run build:nextjs && npm run build:electron",
+    "build:all": "npm run build && npm run build:examples",
+    "lint": "eslint . --quiet",
+    "lint:fix": "eslint . --fix",
+    "lint:all": "npm run lint && npm run lint --workspaces --if-present",
+    "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx,css,json,md}\" \"examples/**/*.{js,jsx,ts,tsx,css,json,md,mjs}\"",
+    "format:check": "prettier --check \"src/**/*.{js,jsx,ts,tsx,css,json,md}\" \"examples/**/*.{js,jsx,ts,tsx,css,json,md,mjs}\"",
+    "format:all": "npm run format && npm run format --workspaces --if-present",
+    "type-check": "tsc --noEmit",
+    "type-check:all": "npm run type-check && npm run type-check --workspaces --if-present",
+    "check": "npm run format:check && npm run lint:all && npm run type-check:all",
+    "check:fix": "npm run format:all && npm run lint:fix && npm run type-check:all",
     "preview": "vite preview",
     "start": "vite",
     "clean": "rimraf lib tsconfig.tsbuildinfo",
@@ -57,11 +74,15 @@
     "typedoc": "typedoc --options typedoc.json --out docs/docs/typescript_api",
     "watch:lib": "run-p 'watch:lib:*'",
     "watch:lib:res": "gulp resources-to-lib-watch",
-    "watch:lib:src": "tsc -b -w"
+    "watch:lib:src": "tsc -b -w",
+    "example": "vite --config vite.examples.config.ts",
+    "example:nextjs": "npm run dev --workspace=nextjs-notebook-example",
+    "example:electron": "cd examples/electron && npm run dev",
+    "prepare": "husky"
   },
   "dependencies": {
     "@datalayer/icons-react": "^1.0.6",
-    "@datalayer/jupyter-react": "^1.0.5",
+    "@datalayer/jupyter-react": "^1.1.0",
     "@datalayer/primer-addons": "^1.0.3",
     "@datalayer/primer-rjsf": "^1.0.1",
     "@jupyterlab/coreutils": "^6.0.0",
@@ -89,7 +110,6 @@
     "react": "18.3.1",
     "react-confetti": "^6.4.0",
     "react-dom": "18.3.1",
-    "react-router-dom": "^6.22.3",
     "tus-js-client": "^4.2.3",
     "ulid": "^2.3.0",
     "unique-names-generator": "^4.7.1",
@@ -97,9 +117,18 @@
     "validator": "^13.7.0",
     "zustand": "^4.4.1"
   },
+  "peerDependencies": {
+    "react-router-dom": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-router-dom": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@chromatic-com/storybook": "^4.1.0",
     "@eslint/js": "^9.29.0",
+    "react-router-dom": "^6.22.3",
     "@storybook/addon-a11y": "^9.1.1",
     "@storybook/addon-docs": "^9.1.1",
     "@storybook/addon-onboarding": "^9.1.1",
@@ -114,6 +143,9 @@
     "@vitest/coverage-v8": "^3.2.4",
     "crypto-browserify": "^3.12.1",
     "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "eslint-plugin-storybook": "^9.1.1",
@@ -122,9 +154,12 @@
     "gulp-append-prepend": "^1.0.8",
     "gulp-filter": "^6.0.0",
     "gulp-watch": "^5.0.1",
+    "husky": "^9.1.7",
     "jsdom": "^26.0.0",
+    "lint-staged": "^16.1.5",
     "npm-run-all": "^4.1.5",
     "playwright": "^1.53.2",
+    "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
     "storybook": "^9.1.1",
     "typedoc-plugin-markdown": "^4.0.0",
@@ -148,5 +183,14 @@
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "typescript": "^5.8.3"
+  },
+  "lint-staged": {
+    "src/**/*.{js,jsx,ts,tsx}": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "src/**/*.{css,json,md}": [
+      "prettier --write"
+    ]
   }
 }

package/lib/__tests__/App.test.js

@@ -1,17 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { describe, it, expect } from 'vitest';
-import { App } from '../App';
-describe('App Component', () => {
-    it('should be a function component', () => {
-        expect(typeof App).toBe('function');
-    });
-    it('should be defined', () => {
-        expect(App).toBeDefined();
-    });
-    it('component name should be App', () => {
-        expect(App.name).toBe('App');
-    });
-});