jupyterlab_vscode_icons_extension 1.0.37

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Stellars Henson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,84 @@
+# JupyterLab VSCode Icons Extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_vscode_icons_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_vscode_icons_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_vscode_icons_extension.svg)](https://www.npmjs.com/package/jupyterlab_vscode_icons_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-vscode-icons-extension.svg)](https://pypi.org/project/jupyterlab-vscode-icons-extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-vscode-icons-extension)](https://pepy.tech/project/jupyterlab-vscode-icons-extension)
+[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
+[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
+
+A shameless, unapologetic, and utterly brazen ripoff of the excellent VSCode file icons for JupyterLab. Because why should VS Code users have all the fun?
+
+This extension brings 1414 beautiful file type icons from the vscode-icons project directly into your JupyterLab file browser. We saw those pretty icons, we wanted them, and now you can have them too - no permission asked, no apologies given (well, we did use the MIT license, so it's all legally kosher)
+
+## Features
+
+![VSCode Icons in JupyterLab](.resources/screenshot-icons.png)
+
+- 1414 file type icons covering virtually every language, framework, and config file you can think of
+- Automatic icon detection based on file extensions and names
+- Zero configuration required - just install and enjoy
+- Lightweight integration using Iconify's JSON icon format
+- Compatible with Jupytext - properly displays Python and Markdown icons for .py and .md notebook files
+- No folders (we left those alone... for now)
+
+## Requirements
+
+- JupyterLab 4.0+
+- A sense of humor about intellectual property (kidding - it's MIT licensed)
+- Appreciation for pretty icons
+
+## Installation
+
+```bash
+pip install jupyterlab_vscode_icons_extension
+```
+
+That's it. Restart JupyterLab and watch your bland, iconless file browser transform into a colorful, VSCode-inspired masterpiece
+
+## Supported File Types
+
+The extension recognizes hundreds of file types including:
+
+- **Languages**: Python, JavaScript, TypeScript, Java, C/C++, Rust, Go, Ruby, PHP, R, Julia, and many more
+- **Web**: HTML, CSS, SCSS, Vue, Svelte, React components
+- **Data**: JSON, YAML, CSV, XML, TOML
+- **Documentation**: Markdown, RST, PDF
+- **Config**: Dockerfile, .gitignore, .env, Makefile, package.json
+- **Notebooks**: Jupyter notebooks (.ipynb)
+
+For the complete list of 1414 icons, see the [vscode-icons project](https://github.com/vscode-icons/vscode-icons)
+
+## Configuration
+
+Customize which icon groups to display via JupyterLab Settings:
+
+1. Open JupyterLab Settings (Settings -> Settings Editor)
+2. Search for "VSCode Icons"
+3. Toggle icon groups on/off:
+   - Programming Language Icons (Python, JS, TS, Java, C++, Rust, Go, etc.)
+   - Web Development Icons (HTML, CSS, Vue, Svelte)
+   - Data Format Icons (JSON, YAML, CSV, XML)
+   - Configuration File Icons (Dockerfile, .gitignore, Makefile, package.json)
+   - Documentation Icons (Markdown, RST, PDF)
+   - Image File Icons (PNG, JPG, SVG)
+
+Changes require a page refresh to take effect.
+
+## Uninstallation
+
+If you somehow tire of beautiful icons (we can't imagine why):
+
+```bash
+pip uninstall jupyterlab_vscode_icons_extension
+```
+
+## Credits
+
+This extension shamelessly borrows icons from the excellent [vscode-icons](https://github.com/vscode-icons/vscode-icons) project by Roberto Huertas. Icons are delivered via [Iconify](https://iconify.design/), because we believe in standing on the shoulders of giants.
+
+All icon assets remain under their original licenses (MIT for code, CC BY-SA for branded icons). We just wrapped them in a JupyterLab extension and called it a day.
+
+## Why This Exists
+
+Because JupyterLab deserves pretty icons too. That's it. That's the whole justification

package/lib/icons.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Icon mappings for file extensions using vscode-icons
+ */
+interface IIconMapping {
+    [key: string]: string;
+}
+/**
+ * Map file extensions to vscode icon names
+ * Based on common file type associations
+ */
+export declare const extensionToIcon: IIconMapping;
+/**
+ * Get icon name for a file
+ * @param filename - The file name
+ * @returns The icon name or default-file if not found
+ */
+export declare function getIconForFile(filename: string): string;
+/**
+ * Get SVG content for an icon
+ * @param iconName - The icon name
+ * @returns The SVG body content
+ */
+export declare function getIconSVG(iconName: string): string;
+/**
+ * Generate complete SVG element for an icon
+ * @param iconName - The icon name
+ * @param className - Optional CSS class name
+ * @returns Complete SVG string
+ */
+export declare function generateIconSVG(iconName: string, className?: string): string;
+export {};

package/lib/icons.js

@@ -0,0 +1,213 @@
+/**
+ * Icon mappings for file extensions using vscode-icons
+ */
+import iconsData from '@iconify-json/vscode-icons/icons.json';
+/**
+ * Map file extensions to vscode icon names
+ * Based on common file type associations
+ */
+export const extensionToIcon = {
+    // Programming languages
+    js: 'file-type-js-official',
+    jsx: 'file-type-reactjs',
+    ts: 'file-type-typescript-official',
+    tsx: 'file-type-reactts',
+    py: 'file-type-python',
+    pyc: 'file-type-python',
+    pyd: 'file-type-python',
+    pyo: 'file-type-python',
+    pyw: 'file-type-python',
+    pyx: 'file-type-cython',
+    ipynb: 'file-type-jupyter',
+    java: 'file-type-java',
+    class: 'file-type-class',
+    jar: 'file-type-jar',
+    c: 'file-type-c',
+    h: 'file-type-c',
+    cpp: 'file-type-cpp',
+    cc: 'file-type-cpp',
+    cxx: 'file-type-cpp',
+    hpp: 'file-type-hpp',
+    cs: 'file-type-csharp',
+    go: 'file-type-go',
+    rs: 'file-type-rust',
+    rb: 'file-type-ruby',
+    php: 'file-type-php',
+    swift: 'file-type-swift',
+    kt: 'file-type-kotlin',
+    kts: 'file-type-kotlin',
+    r: 'file-type-r',
+    R: 'file-type-r',
+    jl: 'file-type-julia',
+    scala: 'file-type-scala',
+    lua: 'file-type-lua',
+    pl: 'file-type-perl',
+    pm: 'file-type-perl',
+    sh: 'file-type-shell',
+    bash: 'file-type-shell',
+    zsh: 'file-type-shell',
+    fish: 'file-type-shell',
+    bat: 'file-type-shell',
+    cmd: 'file-type-shell',
+    ps1: 'file-type-powershell',
+    vbs: 'file-type-vba',
+    vbe: 'file-type-vba',
+    sql: 'file-type-sql',
+    // Web
+    html: 'file-type-html',
+    htm: 'file-type-html',
+    css: 'file-type-css',
+    scss: 'file-type-scss',
+    sass: 'file-type-sass',
+    less: 'file-type-less',
+    vue: 'file-type-vue',
+    svelte: 'file-type-svelte',
+    // Data formats
+    json: 'file-type-json',
+    yaml: 'file-type-yaml',
+    yml: 'file-type-yaml',
+    toml: 'file-type-toml',
+    xml: 'file-type-xml',
+    csv: 'file-type-csv',
+    tsv: 'file-type-csv',
+    // Documentation
+    md: 'file-type-markdown',
+    mdx: 'file-type-mdx',
+    rst: 'file-type-rst',
+    txt: 'file-type-text',
+    pdf: 'file-type-pdf',
+    // Config files
+    gitignore: 'file-type-git',
+    gitattributes: 'file-type-git',
+    gitmodules: 'file-type-git',
+    '.git': 'file-type-git',
+    '.gitignore': 'file-type-git',
+    '.gitattributes': 'file-type-git',
+    '.gitmodules': 'file-type-git',
+    dockerignore: 'file-type-docker',
+    dockerfile: 'file-type-docker',
+    env: 'file-type-dotenv',
+    ini: 'file-type-ini',
+    cfg: 'file-type-config',
+    conf: 'file-type-config',
+    // Package managers
+    'package.json': 'file-type-npm',
+    'package-lock.json': 'file-type-npm',
+    'yarn.lock': 'file-type-yarn',
+    'requirements.txt': 'file-type-python',
+    'pyproject.toml': 'file-type-python',
+    'setup.py': 'file-type-python',
+    Pipfile: 'file-type-python',
+    'Cargo.toml': 'file-type-rust',
+    'Cargo.lock': 'file-type-rust',
+    Gemfile: 'file-type-ruby',
+    'pom.xml': 'file-type-maven',
+    'build.gradle': 'file-type-gradle',
+    // Build tools
+    LICENSE: 'file-type-license',
+    LICENCE: 'file-type-license',
+    license: 'file-type-license',
+    licence: 'file-type-license',
+    webpack: 'file-type-webpack',
+    rollup: 'file-type-rollup',
+    vite: 'file-type-vite',
+    // CI/CD
+    'gitlab-ci.yml': 'file-type-gitlab',
+    '.travis.yml': 'file-type-travis',
+    'circle.yml': 'file-type-circleci',
+    Jenkinsfile: 'file-type-jenkins',
+    // Images
+    png: 'file-type-image',
+    jpg: 'file-type-image',
+    jpeg: 'file-type-image',
+    gif: 'file-type-image',
+    svg: 'file-type-svg',
+    ico: 'file-type-image',
+    webp: 'file-type-image',
+    bmp: 'file-type-image',
+    // Archives
+    zip: 'file-type-zip',
+    tar: 'file-type-zip',
+    gz: 'file-type-zip',
+    bz2: 'file-type-zip',
+    '7z': 'file-type-zip',
+    rar: 'file-type-zip',
+    // Windows specific
+    lnk: 'file-type-lnk',
+    // Other
+    lock: 'file-type-lock',
+    log: 'file-type-log',
+    wasm: 'file-type-wasm',
+    proto: 'file-type-protobuf',
+    graphql: 'file-type-graphql',
+    gql: 'file-type-graphql'
+};
+/**
+ * Get icon name for a file
+ * @param filename - The file name
+ * @returns The icon name or default-file if not found
+ */
+export function getIconForFile(filename) {
+    const lowerFilename = filename.toLowerCase();
+    // Check exact filename matches first
+    if (extensionToIcon[lowerFilename]) {
+        return extensionToIcon[lowerFilename];
+    }
+    // Check for extension
+    const parts = filename.split('.');
+    if (parts.length > 1) {
+        const ext = parts[parts.length - 1].toLowerCase();
+        if (extensionToIcon[ext]) {
+            return extensionToIcon[ext];
+        }
+    }
+    // Check for special prefixes (dot files)
+    if (filename.startsWith('.')) {
+        const nameWithoutDot = filename.slice(1);
+        if (extensionToIcon[nameWithoutDot]) {
+            return extensionToIcon[nameWithoutDot];
+        }
+    }
+    return 'default-file';
+}
+/**
+ * Get SVG content for an icon
+ * @param iconName - The icon name
+ * @returns The SVG body content
+ */
+export function getIconSVG(iconName) {
+    var _a, _b;
+    const icons = iconsData.icons;
+    const aliases = iconsData.aliases;
+    let icon;
+    // First check if it's an alias
+    const alias = aliases === null || aliases === void 0 ? void 0 : aliases[iconName];
+    if (alias === null || alias === void 0 ? void 0 : alias.parent) {
+        // Resolve alias to actual icon
+        icon = icons[alias.parent];
+    }
+    else {
+        // Not an alias, check regular icons
+        icon = icons[iconName];
+    }
+    if (!icon) {
+        icon = icons['default-file'];
+    }
+    // Resolve parent reference if present
+    if (icon === null || icon === void 0 ? void 0 : icon.parent) {
+        const parentIcon = icons[icon.parent];
+        return (parentIcon === null || parentIcon === void 0 ? void 0 : parentIcon.body) || ((_a = icons['default-file']) === null || _a === void 0 ? void 0 : _a.body) || '';
+    }
+    return (icon === null || icon === void 0 ? void 0 : icon.body) || ((_b = icons['default-file']) === null || _b === void 0 ? void 0 : _b.body) || '';
+}
+/**
+ * Generate complete SVG element for an icon
+ * @param iconName - The icon name
+ * @param className - Optional CSS class name
+ * @returns Complete SVG string
+ */
+export function generateIconSVG(iconName, className = '') {
+    const body = getIconSVG(iconName);
+    const classAttr = className ? ` class="${className}"` : '';
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"${classAttr}>${body}</svg>`;
+}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import { JupyterFrontEndPlugin } from '@jupyterlab/application';
+declare const plugin: JupyterFrontEndPlugin<void>;
+export default plugin;