@jlab-enhanced/favorites 3.2.2 → 3.3.0

package/README.md

@@ -37,6 +37,12 @@ To remove the extension, execute:
 pip uninstall jupyterlab_favorites
 ```
 
+## History
+
+This extension was orginally developed by [National Energy Research Scientific Computing Center](https://github.com/NERSC/).
+
+The original (archived) repository can be found here: [NERSC/jupyterlab-favorites](https://github.com/NERSC/jupyterlab-favorites).
+
 ## Contributing
 
 ### Development install

package/lib/index.d.ts

@@ -1,8 +1,10 @@
 import { JupyterFrontEndPlugin } from '@jupyterlab/application';
+import { NotebookPanel } from '@jupyterlab/notebook';
 import { IFavorites } from './token';
-export { IFavorites } from './token';
+export { IFavorites, FAVORITE_TAG } from './token';
 /**
- * Initialization data for the jupyterlab-favorites extension.
+ * Plugin that provides the custom notebook factory with star icons
  */
-declare const favorites: JupyterFrontEndPlugin<IFavorites>;
-export default favorites;
+export declare const notebookFactoryPlugin: JupyterFrontEndPlugin<NotebookPanel.IContentFactory>;
+declare const _default: (JupyterFrontEndPlugin<IFavorites> | JupyterFrontEndPlugin<NotebookPanel.IContentFactory>)[];
+export default _default;

package/lib/index.js

@@ -1,41 +1,61 @@
 import { PageConfig } from '@jupyterlab/coreutils';
 import { IDefaultFileBrowser, IFileBrowserFactory } from '@jupyterlab/filebrowser';
+import { INotebookTracker, NotebookPanel } from '@jupyterlab/notebook';
 import { IMainMenu } from '@jupyterlab/mainmenu';
 import { ISettingRegistry } from '@jupyterlab/settingregistry';
-import { ReactWidget, UseSignal, folderIcon } from '@jupyterlab/ui-components';
+import { ReactWidget, ToolbarButton, UseSignal, folderIcon } from '@jupyterlab/ui-components';
 import { Widget } from '@lumino/widgets';
 import React from 'react';
 import { FavoritesBreadCrumbs, FavoritesWidget } from './components';
 import { starIcon } from './icons';
 import { FavoritesManager } from './manager';
-import { IFavorites, PluginIDs, CommandIDs } from './token';
-import { getFavoritesIcon, getPinnerActionDescription, mergePaths } from './utils';
-import { InputDialog } from '@jupyterlab/apputils';
-export { IFavorites } from './token';
+import { IFavorites, PluginIDs, CommandIDs, SettingIDs, FAVORITE_TAG } from './token';
+import { changeShowStarsOnCells, getFavoritesIcon, getPinnerActionDescription, mergePaths, toggleCellFavorite, updateCellClasses, updateCellFavoriteButton, updateSingleCellClass } from './utils';
+import { ICommandPalette, InputDialog, IToolbarWidgetRegistry } from '@jupyterlab/apputils';
+import { ITranslator, nullTranslator } from '@jupyterlab/translation';
+import { IEditorServices } from '@jupyterlab/codeeditor';
+import { StarredNotebookContentFactory } from './starPrompt';
+export { IFavorites, FAVORITE_TAG } from './token';
 const BREADCRUMBS_CLASS = 'jp-FileBrowser-crumbs';
 /**
  * The class name for the node containing the FileBrowser BreadCrumbs favorite icon.
  */
 const FAVORITE_ITEM_PINNER_CLASS = 'jp-Favorites-pinner';
 /**
- * Modifier class added to breadcrumbs to ensure the favourite icon has enough spacing.
+ * Modifier class added to breadcrumbs to ensure the favorite icon has enough spacing.
  */
 const BREADCUMBS_FAVORITES_CLASS = 'jp-Favorites-crumbs';
+/**
+ * Class set to notebook when filtering cells by favorite is enabled
+ */
+const FAVORITE_FILTER_CLASS = 'jp-favorites-filter-active';
+/**
+ * Setting key for toggling the visibility of star icons on cells.
+ */
+const SHOW_STARS_ON_CELLS = 'showStarsOnCells';
 /**
  * Initialization data for the jupyterlab-favorites extension.
  */
 const favorites = {
     id: PluginIDs.favorites,
     autoStart: true,
-    requires: [IFileBrowserFactory, ISettingRegistry],
+    requires: [IFileBrowserFactory, ISettingRegistry, INotebookTracker],
     provides: IFavorites,
-    optional: [IDefaultFileBrowser, IMainMenu],
-    activate: (app, factory, settingsRegistry, filebrowser, mainMenu) => {
+    optional: [
+        ITranslator,
+        IDefaultFileBrowser,
+        IMainMenu,
+        IToolbarWidgetRegistry,
+        ICommandPalette
+    ],
+    activate: async (app, factory, settingsRegistry, notebookTracker, translator, filebrowser, mainMenu, toolbarRegistry, palette) => {
         console.log('JupyterLab extension jupyterlab-favorites is activated!');
+        const trans = (translator !== null && translator !== void 0 ? translator : nullTranslator).load('jupyterlab');
         const docRegistry = app.docRegistry;
         const { commands, serviceManager } = app;
         const favoritesManager = new FavoritesManager(PageConfig.getOption('serverRoot') || 'Jupyter Server Root', commands, settingsRegistry, serviceManager.contents);
         favoritesManager.init();
+        const favoriteSettings = await settingsRegistry.load(SettingIDs.favorites);
         if (filebrowser) {
             const favoritesWidget = new FavoritesWidget(favoritesManager, filebrowser);
             const layout = filebrowser.layout;
@@ -80,6 +100,21 @@ const favorites = {
             return Array.from(widget.selectedItems());
         };
         const { tracker } = factory;
+        toolbarRegistry === null || toolbarRegistry === void 0 ? void 0 : toolbarRegistry.addFactory('Cell', 'cellFavoriteToggle', args => {
+            const cell = args.model;
+            const tags = cell.getMetadata('tags');
+            const isFavorite = Array.isArray(tags) && tags.includes(FAVORITE_TAG);
+            const button = new ToolbarButton({
+                tooltip: isFavorite ? 'Unfavorite cell' : 'Favorite cell',
+                icon: getFavoritesIcon(isFavorite),
+                onClick: () => toggleCellFavorite(cell)
+            });
+            // Connect metadataChanged signal to update the icon and tooltip dynamically
+            cell.metadataChanged.connect(() => {
+                updateCellFavoriteButton(button, args);
+            });
+            return button;
+        });
         commands.addCommand(CommandIDs.addOrRemoveFavorite, {
             execute: () => {
                 var _a;
@@ -127,6 +162,79 @@ const favorites = {
             icon: starIcon,
             label: 'Remove Favorite'
         });
+        commands.addCommand(CommandIDs.toggleCellFavorite, {
+            execute: () => {
+                const notebookPanel = notebookTracker.currentWidget;
+                if (!notebookPanel || !notebookPanel.content) {
+                    return;
+                }
+                const notebook = notebookPanel.content;
+                const activeCell = notebook.activeCell;
+                if (!activeCell) {
+                    console.warn('No active cell found to toggle favorite');
+                    return;
+                }
+                toggleCellFavorite(activeCell.model);
+            }
+        });
+        const attachViewportListener = (notebook) => {
+            if (!notebook || !notebook.content) {
+                return;
+            }
+            changeShowStarsOnCells(favoriteSettings.get(SHOW_STARS_ON_CELLS).composite, notebook);
+            notebook.content.cellInViewportChanged.connect((_, cell) => {
+                updateSingleCellClass(cell);
+            });
+            notebook.disposed.connect(() => {
+                notebook.content.cellInViewportChanged.disconnect((_, cell) => {
+                    updateSingleCellClass(cell);
+                });
+            });
+        };
+        // Attach to currently open notebooks
+        notebookTracker.forEach(notebook => {
+            attachViewportListener(notebook);
+        });
+        // Attach to any newly opened notebooks
+        notebookTracker.widgetAdded.connect((_, notebook) => {
+            attachViewportListener(notebook);
+        });
+        notebookTracker.currentChanged.connect((_, notebook) => {
+            changeShowStarsOnCells(favoriteSettings.get(SHOW_STARS_ON_CELLS).composite, notebook);
+        });
+        favoriteSettings.changed.connect(() => {
+            changeShowStarsOnCells(favoriteSettings.get(SHOW_STARS_ON_CELLS).composite, notebookTracker.currentWidget);
+        });
+        commands.addCommand(CommandIDs.toggleCellsVisibility, {
+            isToggled: () => {
+                const notebookPanel = notebookTracker.currentWidget;
+                if (!notebookPanel || !notebookPanel.content) {
+                    return false;
+                }
+                return notebookPanel.content.node.classList.contains(FAVORITE_FILTER_CLASS);
+            },
+            label: 'Show Only Favorite Cells',
+            execute: () => {
+                const notebookPanel = notebookTracker.currentWidget;
+                if (!notebookPanel || !notebookPanel.content) {
+                    return;
+                }
+                const notebook = notebookPanel.content;
+                const isFavoriteMode = notebook.node.classList.contains(FAVORITE_FILTER_CLASS);
+                if (isFavoriteMode) {
+                    notebook.node.classList.remove(FAVORITE_FILTER_CLASS);
+                }
+                else {
+                    notebook.node.classList.add(FAVORITE_FILTER_CLASS);
+                }
+                updateCellClasses(notebook);
+            },
+            isEnabled: () => {
+                const currentWidget = app.shell.currentWidget;
+                const notebook = notebookTracker.currentWidget;
+                return !!(notebook !== null && notebook === currentWidget);
+            }
+        });
         commands.addCommand(CommandIDs.renameFavorite, {
             execute: async (args) => {
                 var _a;
@@ -185,6 +293,11 @@ const favorites = {
             execute: () => favoritesManager.clearFavorites(),
             label: 'Clear Favorites'
         });
+        // Add commands to palette
+        palette === null || palette === void 0 ? void 0 : palette.addItem({
+            command: CommandIDs.toggleCellsVisibility,
+            category: trans.__('Notebook Operations')
+        });
         // Main Menu
         if (mainMenu) {
             mainMenu.fileMenu.addGroup([
@@ -238,4 +351,22 @@ const favorites = {
         return favoritesManager;
     }
 };
-export default favorites;
+/**
+ * Plugin that provides the custom notebook factory with star icons
+ */
+export const notebookFactoryPlugin = {
+    id: PluginIDs.notebookFactory,
+    description: 'Provides notebook cell factory with star icons',
+    provides: NotebookPanel.IContentFactory,
+    requires: [IEditorServices],
+    autoStart: true,
+    activate: (app, editorServices) => {
+        const editorFactory = editorServices.factoryService.newInlineEditor;
+        const factory = new StarredNotebookContentFactory({
+            editorFactory,
+            app
+        });
+        return factory;
+    }
+};
+export default [favorites, notebookFactoryPlugin];

package/lib/starPrompt.d.ts

@@ -0,0 +1,24 @@
+import { JupyterFrontEnd } from '@jupyterlab/application';
+import { Widget } from '@lumino/widgets';
+import { Cell, IInputPrompt } from '@jupyterlab/cells';
+import { NotebookPanel } from '@jupyterlab/notebook';
+export declare class StarredInputPrompt extends Widget implements IInputPrompt {
+    private _app;
+    private _executionCount;
+    private _promptIndicator;
+    private _favoriteIconOn;
+    private _favoriteIconOff;
+    constructor(_app: JupyterFrontEnd);
+    get executionCount(): string | null;
+    set executionCount(value: string | null);
+}
+export declare namespace StarredNotebookContentFactory {
+    interface IOptions extends Cell.ContentFactory.IOptions {
+        app: JupyterFrontEnd;
+    }
+}
+export declare class StarredNotebookContentFactory extends NotebookPanel.ContentFactory {
+    private _app;
+    constructor(options: StarredNotebookContentFactory.IOptions);
+    createInputPrompt(): StarredInputPrompt;
+}

package/lib/starPrompt.js

@@ -0,0 +1,61 @@
+import { BoxLayout, Widget } from '@lumino/widgets';
+import { CommandIDs } from './token';
+import { InputPrompt } from '@jupyterlab/cells';
+import { ToolbarButton } from '@jupyterlab/ui-components';
+import { filledStarIcon, starIcon } from './icons';
+import { NotebookPanel } from '@jupyterlab/notebook';
+const INPUT_PROMPT_CLASS = 'jp-InputPrompt';
+const INPUT_PROMPT_NUMBER_CLASS = 'jp-Favorites-InputPromptNumber';
+const FAVORITE_ICON_ON_CLASS = 'jp-Favorites-star-class';
+const FAVORITE_ICON_OFF_CLASS = 'jp-Favorites-star-class-off';
+const FAVORITE_ICON_BASE_CLASS = 'jp-Favorites-base-star-class';
+export class StarredInputPrompt extends Widget {
+    constructor(_app) {
+        super();
+        this._app = _app;
+        this._executionCount = null;
+        this.addClass(INPUT_PROMPT_CLASS);
+        const layout = (this.layout = new BoxLayout({
+            direction: 'right-to-left'
+        }));
+        this._promptIndicator = new InputPrompt();
+        this._promptIndicator.node.classList.add(INPUT_PROMPT_NUMBER_CLASS);
+        layout.addWidget(this._promptIndicator);
+        this._favoriteIconOff = new ToolbarButton({
+            icon: starIcon,
+            onClick: () => {
+                this._app.commands.execute(CommandIDs.toggleCellFavorite);
+            },
+            tooltip: 'Mark as favorite'
+        });
+        this._favoriteIconOff.addClass(FAVORITE_ICON_OFF_CLASS);
+        this._favoriteIconOff.addClass(FAVORITE_ICON_BASE_CLASS);
+        this._favoriteIconOn = new ToolbarButton({
+            icon: filledStarIcon,
+            onClick: () => {
+                this._app.commands.execute(CommandIDs.toggleCellFavorite);
+            },
+            tooltip: 'Remove from favorites'
+        });
+        this._favoriteIconOn.addClass(FAVORITE_ICON_ON_CLASS);
+        this._favoriteIconOn.addClass(FAVORITE_ICON_BASE_CLASS);
+        layout.addWidget(this._favoriteIconOff);
+        layout.addWidget(this._favoriteIconOn);
+    }
+    get executionCount() {
+        return this._executionCount;
+    }
+    set executionCount(value) {
+        this._executionCount = value;
+        this._promptIndicator.executionCount = value;
+    }
+}
+export class StarredNotebookContentFactory extends NotebookPanel.ContentFactory {
+    constructor(options) {
+        super(options);
+        this._app = options.app;
+    }
+    createInputPrompt() {
+        return new StarredInputPrompt(this._app);
+    }
+}

package/lib/token.d.ts

@@ -1,7 +1,9 @@
 import { Token } from '@lumino/coreutils';
 export declare namespace PluginIDs {
     const favorites = "jupyterlab-favorites";
+    const notebookFactory = "favorites-notebook-factory";
 }
+export type ShowStarsTypes = 'allCells' | 'onlyFavoriteCells' | 'never';
 export declare namespace CommandIDs {
     const addOrRemoveFavorite: string;
     const removeFavorite: string;
@@ -10,6 +12,9 @@ export declare namespace CommandIDs {
     const toggleFavoritesWidget: string;
     const restoreDefaults: string;
     const clearFavorites: string;
+    const toggleCellsVisibility: string;
+    const addFavoriteClasses: string;
+    const toggleCellFavorite: string;
 }
 export declare namespace SettingIDs {
     const themes = "@jupyterlab/apputils-extension:themes";
@@ -34,3 +39,7 @@ export declare const IFavorites: Token<IFavorites>;
 export interface IFavorites {
     readonly favorites: IFavorites.Favorite[];
 }
+/**
+ * Cell tag used to mark cell as favorite
+ */
+export declare const FAVORITE_TAG = "favorite";

package/lib/token.js

@@ -2,6 +2,7 @@ import { Token } from '@lumino/coreutils';
 export var PluginIDs;
 (function (PluginIDs) {
     PluginIDs.favorites = 'jupyterlab-favorites';
+    PluginIDs.notebookFactory = 'favorites-notebook-factory';
 })(PluginIDs || (PluginIDs = {}));
 export var CommandIDs;
 (function (CommandIDs) {
@@ -12,6 +13,9 @@ export var CommandIDs;
     CommandIDs.toggleFavoritesWidget = `${PluginIDs.favorites}:toggle-favorites-widget`;
     CommandIDs.restoreDefaults = `${PluginIDs.favorites}:restore-defaults`;
     CommandIDs.clearFavorites = `${PluginIDs.favorites}:clear-favorites`;
+    CommandIDs.toggleCellsVisibility = `${PluginIDs.favorites}:toggle-cell-visibility`;
+    CommandIDs.addFavoriteClasses = `${PluginIDs.favorites}:toggle-favorite-classes`;
+    CommandIDs.toggleCellFavorite = `${PluginIDs.favorites}:toggle-cell-favorite`;
 })(CommandIDs || (CommandIDs = {}));
 export var SettingIDs;
 (function (SettingIDs) {
@@ -19,3 +23,7 @@ export var SettingIDs;
     SettingIDs.favorites = '@jlab-enhanced/favorites:favorites';
 })(SettingIDs || (SettingIDs = {}));
 export const IFavorites = new Token('jupyterlab-favorites:IFavorites');
+/**
+ * Cell tag used to mark cell as favorite
+ */
+export const FAVORITE_TAG = 'favorite';

package/lib/utils.d.ts

@@ -1,4 +1,7 @@
-import { LabIcon } from '@jupyterlab/ui-components';
+import { LabIcon, ToolbarButton } from '@jupyterlab/ui-components';
+import { Cell, ICellModel } from '@jupyterlab/cells';
+import { Notebook, NotebookPanel } from '@jupyterlab/notebook';
+import { ShowStarsTypes } from './token';
 export declare function getFavoritesIcon(filled: boolean): LabIcon;
 /**
  * Split the file path in two parts: the name and the folder
@@ -9,3 +12,8 @@ export declare function getName(path: string): [string, string];
 export declare function getPinnerActionDescription(showRemove: boolean): string;
 export declare function mergePaths(root: string, path: string): string;
 export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+export declare function updateCellFavoriteButton(button: ToolbarButton, cell: Cell<ICellModel>): void;
+export declare function toggleCellFavorite(cell: ICellModel): void;
+export declare function updateCellClasses(notebook: Notebook): void;
+export declare function updateSingleCellClass(cell: Cell<ICellModel>): void;
+export declare function changeShowStarsOnCells(type: ShowStarsTypes, notebookPanel: NotebookPanel | null): void;

package/lib/utils.js

@@ -1,5 +1,9 @@
 import { filledStarIcon, starIcon } from './icons';
 import { PathExt } from '@jupyterlab/coreutils';
+import { FAVORITE_TAG } from './token';
+const FAVORITE_CELL_CLASS = 'jp-favorite-cell';
+const SHOW_ALL_STARS = 'jp-Favorites-show-all-stars';
+const NEVER_SHOW_STARS = 'jp-Favorites-never-show-stars';
 export function getFavoritesIcon(filled) {
     return filled ? filledStarIcon : starIcon;
 }
@@ -17,3 +21,104 @@ export function getPinnerActionDescription(showRemove) {
 export function mergePaths(root, path) {
     return PathExt.join(root, path);
 }
+export function updateCellFavoriteButton(button, cell) {
+    const tags = cell.model.getMetadata('tags');
+    const isFavorite = Array.isArray(tags) && tags.includes(FAVORITE_TAG);
+    if (isFavorite) {
+        cell.addClass(FAVORITE_CELL_CLASS);
+    }
+    else {
+        cell.removeClass(FAVORITE_CELL_CLASS);
+    }
+    // Update tooltip
+    const tooltip = isFavorite ? 'Unfavorite cell' : 'Favorite cell';
+    const jpButton = button.node.querySelector('jp-button');
+    if (jpButton) {
+        jpButton.setAttribute('aria-label', tooltip);
+        jpButton.setAttribute('title', tooltip);
+    }
+    button.node.setAttribute('title', tooltip);
+    // Replace the SVG in the button
+    const icon = getFavoritesIcon(isFavorite);
+    const svgElement = button.node.querySelector('svg');
+    if (svgElement) {
+        svgElement.outerHTML = icon.svgstr;
+    }
+    else {
+        button.node.innerHTML = icon.svgstr;
+    }
+}
+export function toggleCellFavorite(cell) {
+    let tags = cell.getMetadata('tags');
+    if (Array.isArray(tags)) {
+        const favIndex = tags.indexOf(FAVORITE_TAG);
+        if (favIndex === -1) {
+            tags = [...tags, FAVORITE_TAG];
+        }
+        else {
+            tags = tags.filter(tag => tag !== FAVORITE_TAG);
+        }
+        if (tags.length === 0) {
+            cell.deleteMetadata('tags');
+        }
+        else {
+            cell.setMetadata('tags', tags);
+        }
+    }
+    else {
+        cell.setMetadata('tags', [FAVORITE_TAG]);
+    }
+}
+export function updateCellClasses(notebook) {
+    notebook.widgets.forEach(widget => {
+        const cell = widget;
+        const tags = cell.model.getMetadata('tags');
+        const isFav = Array.isArray(tags) && tags.includes(FAVORITE_TAG);
+        if (isFav) {
+            cell.node.classList.add(FAVORITE_CELL_CLASS);
+        }
+        else {
+            cell.node.classList.remove(FAVORITE_CELL_CLASS);
+        }
+    });
+}
+export function updateSingleCellClass(cell) {
+    const tags = cell.model.getMetadata('tags');
+    const isFav = Array.isArray(tags) && tags.includes(FAVORITE_TAG);
+    if (isFav) {
+        cell.addClass(FAVORITE_CELL_CLASS);
+    }
+    else {
+        cell.removeClass(FAVORITE_CELL_CLASS);
+    }
+}
+export function changeShowStarsOnCells(type, notebookPanel) {
+    if (!notebookPanel || !notebookPanel.content) {
+        return;
+    }
+    const notebook = notebookPanel.content;
+    const toggleClass = (className, shouldAdd) => {
+        if (shouldAdd) {
+            if (!notebook.node.classList.contains(className)) {
+                notebook.node.classList.add(className);
+            }
+        }
+        else {
+            if (notebook.node.classList.contains(className)) {
+                notebook.node.classList.remove(className);
+            }
+        }
+    };
+    if (type === 'allCells') {
+        toggleClass(NEVER_SHOW_STARS, false);
+        toggleClass(SHOW_ALL_STARS, true);
+    }
+    else if (type === 'onlyFavoriteCells') {
+        toggleClass(NEVER_SHOW_STARS, false);
+        toggleClass(SHOW_ALL_STARS, false);
+    }
+    else if (type === 'never') {
+        toggleClass(SHOW_ALL_STARS, false);
+        toggleClass(NEVER_SHOW_STARS, true);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jlab-enhanced/favorites",
-    "version": "3.2.2",
+    "version": "3.3.0",
     "description": "Add the ability to save favorite folders to JupyterLab for quicker browsing",
     "keywords": [
         "jupyter",
@@ -70,10 +70,12 @@
     "dependencies": {
         "@jupyterlab/application": "^4.0.5",
         "@jupyterlab/apputils": "^4.1.5",
+        "@jupyterlab/cells": "^4.0.5",
         "@jupyterlab/coreutils": "^6.0.5",
         "@jupyterlab/docregistry": "^4.0.5",
         "@jupyterlab/filebrowser": "^4.0.5",
         "@jupyterlab/mainmenu": "^4.0.5",
+        "@jupyterlab/notebook": "^4.0.5",
         "@jupyterlab/services": "^7.0.5",
         "@jupyterlab/settingregistry": "^4.0.5",
         "@jupyterlab/ui-components": "^4.0.5",

package/schema/favorites.json

@@ -23,7 +23,7 @@
         },
         "root": {
           "type": "string",
-          "description": "Root path used for filtering out favourites from instances of JupyterLab launched in a different root directory. If not given the favourite will be shown if the associated file exists."
+          "description": "Root path used for filtering out favorites from instances of JupyterLab launched in a different root directory. If not given the favorite will be shown if the associated file exists."
         }
       },
       "required": ["path"],
@@ -48,6 +48,25 @@
         "rank": 3,
         "selector": ".jp-DirListing-item[data-isdir]"
       }
+    ],
+    "main": [
+      {
+        "id": "jp-mainmenu-view",
+        "rank": 10,
+        "items": [
+          {
+            "command": "jupyterlab-favorites:toggle-cell-visibility"
+          }
+        ]
+      }
+    ]
+  },
+  "jupyter.lab.toolbars": {
+    "Cell": [
+      {
+        "name": "cellFavoriteToggle",
+        "rank": 110
+      }
     ]
   },
   "jupyter.lab.setting-icon": "jupyterlab-favorites:filledStar",
@@ -67,6 +86,17 @@
       "description": "Toggles the favorites widget above the filebrowser breadcrumbs.",
       "title": "Show Widget",
       "type": "boolean"
+    },
+    "showStarsOnCells": {
+      "type": "string",
+      "title": "Show Stars on Cells",
+      "description": "Controls the visibility of star icons on cells.",
+      "default": "onlyFavoriteCells",
+      "oneOf": [
+        { "const": "allCells", "title": "All Cells" },
+        { "const": "onlyFavoriteCells", "title": "Only favorite Cells" },
+        { "const": "never", "title": "Never" }
+      ]
     }
   },
   "title": "Favorites",

package/style/base.css

@@ -12,6 +12,13 @@
   margin-top: -5px;
 }
 
+.jp-Favorites-InputPromptNumber {
+  left: 12px !important;
+  width: 51px !important;
+  top: 0 !important;
+  height: 23px !important;
+}
+
 .jp-Favorites-crumbs {
   margin-right: 40px;
 }
@@ -77,3 +84,54 @@
   font-size: var(--jp-ui-font-size0);
   margin: 0 4px;
 }
+
+.jp-Notebook.jp-favorites-filter-active .jp-Cell:not(.jp-favorite-cell) {
+  display: none !important;
+}
+
+.jp-Favorites-base-star-class {
+  top: -2px !important;
+  left: -6px !important;
+  height: 23px !important;
+  width: 24px !important;
+}
+
+.jp-Cell.jp-favorite-cell .jp-Favorites-star-class {
+  display: block !important;
+}
+
+.jp-Cell.jp-favorite-cell .jp-Favorites-star-class-off {
+  display: none !important;
+}
+
+.jp-Notebook.jp-Favorites-show-all-stars
+  .jp-Cell:not(.jp-favorite-cell)
+  .jp-Favorites-star-class-off {
+  display: block !important;
+}
+
+.jp-Notebook:not(.jp-Favorites-show-all-stars)
+  .jp-Cell:not(.jp-favorite-cell)
+  .jp-Favorites-star-class-off {
+  display: none !important;
+}
+
+.jp-Cell:not(.jp-favorite-cell) .jp-Favorites-star-class {
+  display: none !important;
+}
+
+.jp-Notebook .jp-Cell.jp-mod-dirty .jp-InputPrompt::before {
+  content: none !important;
+}
+
+.jp-Notebook.jp-Favorites-never-show-stars .jp-Favorites-base-star-class {
+  display: none !important;
+}
+
+@media only screen and (width <= 760px) {
+  .jp-InputPrompt {
+    flex: 0 0 var(--jp-cell-prompt-width) !important;
+    margin-bottom: -30px !important;
+    text-align: left;
+  }
+}

package/style/icons/md/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.