jupyterlab-file-browser-sorting-extension 1.0.4__tar.gz

jupyterlab_file_browser_sorting_extension-1.0.4/.claude/CLAUDE.md

@@ -0,0 +1,27 @@
+<!-- Import workspace-level CLAUDE.md configuration -->
+<!-- See /home/lab/workspace/.claude/CLAUDE.md for complete rules -->
+
+# Project-Specific Configuration
+
+This file extends workspace-level configuration with project-specific rules.
+
+## Project Context
+
+JupyterLab extension providing file browser sorting capabilities including case-sensitive sorting options.
+
+**Technology Stack**:
+
+- TypeScript for frontend extension code
+- JupyterLab 4.x extension API
+- Python packaging with `pyproject.toml` and `hatch`
+
+**Package Names**:
+
+- npm: `jupyterlab_file_browser_sorting_extension`
+- PyPI: `jupyterlab-file-browser-sorting-extension`
+- GitHub: `stellarshenson/jupyterlab_file_browser_sorting_extension`
+
+**Build and Install**:
+
+- Always use `make install` to build and install the extension
+- Always commit both `package.json` and `package-lock.json` together

jupyterlab_file_browser_sorting_extension-1.0.4/.claude/JOURNAL.md

@@ -0,0 +1,26 @@
+# Claude Code Journal
+
+This journal tracks substantive work on documents, diagrams, and documentation content.
+
+---
+
+1. **Task - Project initialization** (v0.4.2): Created new JupyterLab extension `jupyterlab_file_browser_sorting_extension` using copier template<br>
+   **Result**: Initialized extension project with TypeScript frontend, Python packaging via `pyproject.toml`, GitHub Actions workflows for build/publish/release, Jest unit tests, Playwright integration tests, and Makefile for standardized build commands. Extension provides file browser sorting capabilities including case-sensitive sorting. Created `.claude/CLAUDE.md` with project-specific configuration importing workspace-level rules. Updated `README.md` with standard GitHub badges (build status, npm, PyPI, downloads, JupyterLab 4, KOLOMOLO branding) and brief feature description. Project requires JupyterLab >= 4.0.0.
+
+2. **Task - LC_COLLATE=C sorting implementation** (v0.4.2): Implemented ASCIIbetical sorting for JupyterLab file browser<br>
+   **Result**: Researched JupyterLab 4.x file browser internals - the `DirListing` class in `@jupyterlab/filebrowser` handles sorting via private `_sortedItems` array populated by `Private.sort()` function using `localeCompare` with `sensitivity: 'base'` (case-insensitive). Implemented monkey-patching approach in `src/index.ts` that overrides `DirListing.sort()` method to use custom `cLocaleCompare()` function implementing LC_COLLATE=C ordering: dot files first, then numbers (0-9), uppercase (A-Z), underscore, lowercase (a-z). Added dependencies `@jupyterlab/filebrowser` and `@jupyterlab/settingregistry` to `package.json`. Extension hooks into `IFileBrowserFactory.tracker` to patch both existing and newly created file browsers. Respects JupyterLab's `sortNotebooksFirst` setting and maintains directory-first ordering. Updated README with LC_COLLATE=C explanation and example sort order.
+
+3. **Task - Menu toggle for sorting mode** (v0.4.2): Added context menu toggle for Unix-style sorting<br>
+   **Result**: Created `schema/plugin.json` with `useCLocaleSorting` boolean setting (default: true) for persistent configuration. Added `schemaDir` reference to `package.json` jupyterlab section. Registered toggle command `filebrowser:toggle-unix-sorting` with `isToggleable: true` that updates setting via `ISettingRegistry`. Added command to file browser context menu with selector `.jp-DirListing-content` at rank 10.5 (near "Sort Notebooks Above Files"). Refactored `sortItems()` function to accept `useCLocale` parameter and switch between `cLocaleCompare()` and standard `localeCompare()` based on setting. Added `resortAllBrowsers()` function that triggers re-sort on all patched browsers when settings change. Updated README with usage instructions for the context menu toggle.
+
+4. **Task - Fix DirListing property access** (v0.4.10): Fixed critical bug where sorting toggle had no effect<br>
+   **Result**: Investigated JupyterLab source to find correct property name for accessing DirListing from FileBrowser. The `browser.d.ts` type declarations revealed that the property is `protected listing: DirListing` (not `_listing` as initially assumed). Changed two occurrences in `src/index.ts` from `(browser as any)._listing` to `(browser as any).listing` - in both `resortAllBrowsers()` function and `patchFileBrowser()` function. This fix enables the extension to properly patch the DirListing's sort method and apply custom LC_COLLATE=C sorting when the setting is toggled.
+
+5. **Task - Complete LC_COLLATE=C sorting extension** (v1.0.2): Finalized working Unix-style file browser sorting extension<br>
+   **Result**: Completed fully functional JupyterLab 4.x extension implementing LC*COLLATE=C (ASCIIbetical) sorting for the file browser. The extension monkey-patches `DirListing.sort()` method via `IFileBrowserFactory.tracker` to intercept sorting operations. Core sorting implemented in `cLocaleCompare()` function that compares strings character-by-character using ASCII code values, producing sort order: `.` (46) -> `0-9` (48-57) -> `A-Z` (65-90) -> `*`(95) ->`a-z`(97-122). This matches Unix`LC_COLLATE=C ls`behavior where dotfiles appear first, uppercase precedes lowercase, and special characters sort by ASCII value. The`sortItems()`function maintains JupyterLab's directory-first convention and respects the`sortNotebooksFirst`setting from`@jupyterlab/filebrowser-extension:browser`. Extension provides persistent `useCLocaleSorting`boolean setting in`schema/plugin.json`(default: true) stored via`ISettingRegistry`. Added toggleable context menu command `filebrowser:toggle-unix-sorting`labeled "Unix Style Sorting" with selectors`.jp-DirListing-item`and`.jp-DirListing`at rank 100 (bottom of menu). Settings changes trigger`resortAllBrowsers()`which iterates all tracked FileBrowser widgets and re-applies sorting. The`patchListing()`function hooks into`model.refreshed`signal to automatically re-sort when directory contents change. Key fix during development: FileBrowser exposes DirListing via protected`listing`property (not private`\_listing`), requiring access via `(browser as any).listing`. Removed all debug console.log statements for production release. Extension built with TypeScript strict mode, uses `skipLibCheck: true`to handle lib0 type compatibility issues, and pins lib0 to 0.2.97 via resolutions. Final artefacts:`src/index.ts`(261 lines),`schema/plugin.json`(15 lines), standard JupyterLab extension packaging with`pyproject.toml`and`package.json`.
+
+6. **Task - Fix sortedItems getter override** (v1.0.3): Fixed dotfiles appearing in wrong position despite correct sorting logic<br>
+   **Result**: Discovered that setting `_sortedItems` private field was insufficient because JupyterLab's DirListing uses a `sortedItems` getter that may recalculate the sorted array internally, bypassing our custom sorted data. Fixed by using `Object.defineProperty()` to override the `sortedItems` getter on the listing instance, returning our custom sorted array stored in closure variable `customSortedItems`. The patched `sort()` method now updates both `customSortedItems` (for the getter) and `_sortedItems` (for compatibility). Simplified `resortListing()` to delegate to the patched `listing.sort()` method instead of duplicating sorting logic. This ensures that regardless of whether JupyterLab accesses sorted items via the getter or private field, our LC_COLLATE=C sorted order is used consistently.
+
+7. **Task - GitHub CI/CD workflows** (v1.0.3): Added complete GitHub Actions CI/CD pipeline<br>
+   **Result**: Copied and adapted workflow files from `jupyterlab_fit_image_size_extension` reference project. Added `build.yml` implementing full CI pipeline: linting with eslint/prettier, Jest unit tests, extension build verification via `jupyter labextension list`, isolated installation test without Node.js, Playwright integration tests with browser caching, and link checking with ignore patterns for badge URLs. Added `check-release.yml` for release validation using jupyter_releaser. Added `prep-release.yml` and `publish-release.yml` for automated release workflow with GitHub App token support and NPM publishing. Added `enforce-label.yml` for PR triage label enforcement. Added `update-integration-tests.yml` for updating Playwright snapshots via PR comments. Ran `jlpm run lint` to format all TypeScript and markdown files with prettier and eslint. All workflow files reference correct extension name `jupyterlab_file_browser_sorting_extension` and PyPI name `jupyterlab-file-browser-sorting-extension`.

jupyterlab_file_browser_sorting_extension-1.0.4/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git init:*)",
+      "Bash(git add:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(ls:*)",
+      "Bash(make install:*)",
+      "Bash(git commit:*)",
+      "Bash(git tag:*)",
+      "Bash(git remote add:*)",
+      "Bash(git branch:*)",
+      "Bash(git push:*)",
+      "Bash(jlpm run lint:*)",
+      "Bash(make upgrade:*)"
+    ]
+  }
+}

jupyterlab_file_browser_sorting_extension-1.0.4/.copier-answers.yml

@@ -0,0 +1,16 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: v4.5.1
+_src_path: https://github.com/jupyterlab/extension-template
+author_email: konrad.jelen@gmail.com
+author_name: Stellars Henson
+has_ai_rules: false
+has_binder: false
+has_settings: false
+kind: frontend
+labextension_name: jupyterlab_file_browser_sorting_extension
+project_short_description: Jupyterlab extension to help with sorting of the files
+    in file browser (i.e. case sensitive sorting)
+python_name: jupyterlab_file_browser_sorting_extension
+repository: ''
+test: true
+

jupyterlab_file_browser_sorting_extension-1.0.4/.gitignore

@@ -0,0 +1,128 @@
+*.bundle.*
+lib/
+node_modules/
+*.log
+.eslintcache
+.stylelintcache
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+jupyterlab_file_browser_sorting_extension/labextension
+# Version file is handled by hatchling
+jupyterlab_file_browser_sorting_extension/_version.py
+
+# Integration tests
+ui-tests/test-results/
+ui-tests/playwright-report/
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Virtual environments
+.venv
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage/
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# End of https://www.gitignore.io/api/python
+
+# OSX files
+.DS_Store
+
+# Yarn cache
+.yarn/

jupyterlab_file_browser_sorting_extension-1.0.4/.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+**/node_modules
+**/lib
+**/package.json
+!/package.json
+jupyterlab_file_browser_sorting_extension

jupyterlab_file_browser_sorting_extension-1.0.4/.yarnrc.yml

@@ -0,0 +1,2 @@
+nodeLinker: node-modules
+enableScripts: false

jupyterlab_file_browser_sorting_extension-1.0.4/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+<!-- <START NEW CHANGELOG ENTRY> -->
+
+<!-- <END NEW CHANGELOG ENTRY> -->

jupyterlab_file_browser_sorting_extension-1.0.4/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.

jupyterlab_file_browser_sorting_extension-1.0.4/Makefile

@@ -0,0 +1,122 @@
+# Makefile for Jupyterlab extensions version 1.27
+# author: Stellars Henson <konrad.jelen@gmail.com>
+# License: MIT Open Source License
+
+.PHONY: build install clean uninstall publish dependencies mrproper increment_version install_dependencies check_dependencies upgrade help test
+.DEFAULT_GOAL := help
+
+# Read current version from package.json (only if node is available)
+VERSION := $(shell command -v node >/dev/null 2>&1 && node -p "require('./package.json').version" || echo "0.0.0")
+
+## increment project version
+increment_version:
+	@echo "Current version: $(VERSION)"
+	@bash -c 'CURRENT_VERSION=$(VERSION); \
+	IFS="." read -r major minor patch <<< "$$CURRENT_VERSION"; \
+	NEW_PATCH=$$((patch + 1)); \
+	NEW_VERSION="$$major.$$minor.$$NEW_PATCH"; \
+	echo "New version: $$NEW_VERSION"; \
+	sed -i "s/\"version\": \"$$CURRENT_VERSION\"/\"version\": \"$$NEW_VERSION\"/" package.json; '
+
+## build packages
+build: clean increment_version check_dependencies
+	npm install
+	yarn install
+	python -m build
+
+## install package
+install: build
+	pip install dist/*.whl --force-reinstall
+
+## run tests
+test: check_dependencies
+	jlpm test
+
+## clean builds and installables
+clean: uninstall  check_dependencies
+	@command -v npm >/dev/null 2>&1 && npm run clean || true
+	@command -v npm >/dev/null 2>&1 && npm run clean:labextension || true
+	rm -rf dist lib || true
+
+## uninstall package
+uninstall:  check_dependencies
+	pip uninstall -y dist/*.whl 2>/dev/null || true
+
+## check if required dependencies are installed
+check_dependencies:
+	@echo "Checking dependencies..."
+	@MISSING=""; \
+	command -v node >/dev/null 2>&1 || MISSING="$$MISSING node"; \
+	command -v npm >/dev/null 2>&1 || MISSING="$$MISSING npm"; \
+	command -v yarn >/dev/null 2>&1 || MISSING="$$MISSING yarn"; \
+	command -v twine >/dev/null 2>&1 || MISSING="$$MISSING twine"; \
+	if [ -n "$$MISSING" ]; then \
+		echo "Missing dependencies:$$MISSING"; \
+		echo "Installing missing dependencies..."; \
+		$(MAKE) install_dependencies; \
+	else \
+		echo "All dependencies are installed."; \
+	fi
+
+## publish package to public repository
+publish: check_dependencies install
+	npm publish --access public
+	twine upload dist/*
+
+## install all required build dependencies
+install_dependencies:
+	conda install -y nodejs yarn --update-all
+	pip install twine
+	npm install rimraf
+
+## upgrade all npm and yarn dependencies
+upgrade: check_dependencies
+	jlpm up
+
+## cleanup all build and metabuild artefacts
+mrproper: clean uninstall
+	rm -rf node_modules .yarn || true
+
+## prints the list of available commands
+help:
+	@echo ""
+	@echo "$$(tput bold)Available rules:$$(tput sgr0)"
+	@sed -n -e "/^## / { \
+		h; \
+		s/.*//; \
+		:doc" \
+		-e "H; \
+		n; \
+		s/^## //; \
+		t doc" \
+		-e "s/:.*//; \
+		G; \
+		s/\\n## /---/; \
+		s/\\n/ /g; \
+		p; \
+	}" ${MAKEFILE_LIST} \
+	| LC_ALL='C' sort --ignore-case \
+	| awk -F '---' \
+		-v ncol=$$(tput cols) \
+		-v indent=19 \
+		-v col_on="$$(tput setaf 6)" \
+		-v col_off="$$(tput sgr0)" \
+	'{ \
+		printf "%s%*s%s ", col_on, -indent, $$1, col_off; \
+		n = split($$2, words, " "); \
+		line_length = ncol - indent; \
+		for (i = 1; i <= n; i++) { \
+			line_length -= length(words[i]) + 1; \
+			if (line_length <= 0) { \
+				line_length = ncol - indent - length(words[i]) - 1; \
+				printf "\n%*s ", -indent, " "; \
+			} \
+			printf "%s ", words[i]; \
+		} \
+		printf "\n"; \
+	}' 
+	@echo ""
+
+
+# EOF
+

jupyterlab_file_browser_sorting_extension-1.0.4/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: jupyterlab_file_browser_sorting_extension
+Version: 1.0.4
+Summary: Jupyterlab extension to help with sorting of the files in file browser (i.e. case sensitive sorting)
+Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension
+Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension/issues
+Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension.git
+Author-email: Stellars Henson <konrad.jelen@gmail.com>
+License: 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.
+License-File: LICENSE
+Keywords: jupyter,jupyterlab,jupyterlab-extension
+Classifier: Framework :: Jupyter
+Classifier: Framework :: Jupyter :: JupyterLab
+Classifier: Framework :: Jupyter :: JupyterLab :: 4
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# jupyterlab_file_browser_sorting_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_file_browser_sorting_extension.svg)](https://www.npmjs.com/package/jupyterlab_file_browser_sorting_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-file-browser-sorting-extension.svg)](https://pypi.org/project/jupyterlab-file-browser-sorting-extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-file-browser-sorting-extension)](https://pepy.tech/project/jupyterlab-file-browser-sorting-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)
+
+JupyterLab extension that implements LC_COLLATE=C (ASCIIbetical) sorting for the file browser.
+
+## Features
+
+- **LC_COLLATE=C sorting** - Standard Unix sorting order used by `ls` with C locale
+- **Dot files first** - Hidden files (starting with `.`) appear before other files
+- **Uppercase before lowercase** - Capital letters (A-Z) sort before lowercase (a-z)
+- **ASCII order** - Characters sorted by their ASCII code values
+- **Toggle via context menu** - Right-click in the file browser to enable/disable
+
+## Usage
+
+Right-click anywhere in the file browser content area and select **"Use Unix-Style Sorting (LC_COLLATE=C)"** to toggle the sorting mode. The setting is persisted across sessions.
+
+When enabled, the extension sorts files using the standard Unix C locale collation sequence:
+
+```
+. (dot) -> 0-9 -> A-Z -> _ (underscore) -> a-z
+```
+
+**Example sort order:**
+
+```
+.hidden
+.profile
+123file
+ABC
+Makefile
+README
+_config
+abc
+readme
+zebra
+```
+
+This matches the behavior of `LC_COLLATE=C ls` on Unix systems.
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+
+## Installation
+
+```bash
+pip install jupyterlab_file_browser_sorting_extension
+```
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab_file_browser_sorting_extension
+```

jupyterlab_file_browser_sorting_extension-1.0.4/README.md

@@ -0,0 +1,61 @@
+# jupyterlab_file_browser_sorting_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_file_browser_sorting_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_file_browser_sorting_extension.svg)](https://www.npmjs.com/package/jupyterlab_file_browser_sorting_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-file-browser-sorting-extension.svg)](https://pypi.org/project/jupyterlab-file-browser-sorting-extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-file-browser-sorting-extension)](https://pepy.tech/project/jupyterlab-file-browser-sorting-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)
+
+JupyterLab extension that implements LC_COLLATE=C (ASCIIbetical) sorting for the file browser.
+
+## Features
+
+- **LC_COLLATE=C sorting** - Standard Unix sorting order used by `ls` with C locale
+- **Dot files first** - Hidden files (starting with `.`) appear before other files
+- **Uppercase before lowercase** - Capital letters (A-Z) sort before lowercase (a-z)
+- **ASCII order** - Characters sorted by their ASCII code values
+- **Toggle via context menu** - Right-click in the file browser to enable/disable
+
+## Usage
+
+Right-click anywhere in the file browser content area and select **"Use Unix-Style Sorting (LC_COLLATE=C)"** to toggle the sorting mode. The setting is persisted across sessions.
+
+When enabled, the extension sorts files using the standard Unix C locale collation sequence:
+
+```
+. (dot) -> 0-9 -> A-Z -> _ (underscore) -> a-z
+```
+
+**Example sort order:**
+
+```
+.hidden
+.profile
+123file
+ABC
+Makefile
+README
+_config
+abc
+readme
+zebra
+```
+
+This matches the behavior of `LC_COLLATE=C ls` on Unix systems.
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+
+## Installation
+
+```bash
+pip install jupyterlab_file_browser_sorting_extension
+```
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab_file_browser_sorting_extension
+```

jupyterlab_file_browser_sorting_extension-1.0.4/RELEASE.md

@@ -0,0 +1,80 @@
+# Making a new release of jupyterlab_file_browser_sorting_extension
+
+The extension can be published to `PyPI` and `npm` manually or using the [Jupyter Releaser](https://github.com/jupyter-server/jupyter_releaser).
+
+## Manual release
+
+### Python package
+
+This extension can be distributed as Python packages. All of the Python
+packaging instructions are in the `pyproject.toml` file to wrap your extension in a
+Python package. Before generating a package, you first need to install some tools:
+
+```bash
+pip install build twine hatch
+```
+
+Bump the version using `hatch`. By default this will create a tag.
+See the docs on [hatch-nodejs-version](https://github.com/agoose77/hatch-nodejs-version#semver) for details.
+
+```bash
+hatch version <new-version>
+```
+
+Make sure to clean up all the development files before building the package:
+
+```bash
+jlpm clean:all
+```
+
+You could also clean up the local git repository:
+
+```bash
+git clean -dfX
+```
+
+To create a Python source package (`.tar.gz`) and the binary package (`.whl`) in the `dist/` directory, do:
+
+```bash
+python -m build
+```
+
+> `python setup.py sdist bdist_wheel` is deprecated and will not work for this package.
+
+Then to upload the package to PyPI, do:
+
+```bash
+twine upload dist/*
+```
+
+### NPM package
+
+To publish the frontend part of the extension as a NPM package, do:
+
+```bash
+npm login
+npm publish --access public
+```
+
+## Automated releases with the Jupyter Releaser
+
+The extension repository should already be compatible with the Jupyter Releaser. But
+the GitHub repository and the package managers need to be properly set up. Please
+follow the instructions of the Jupyter Releaser [checklist](https://jupyter-releaser.readthedocs.io/en/latest/how_to_guides/convert_repo_from_repo.html).
+
+Here is a summary of the steps to cut a new release:
+
+- Go to the Actions panel
+- Run the "Step 1: Prep Release" workflow
+- Check the draft changelog
+- Run the "Step 2: Publish Release" workflow
+
+> [!NOTE]
+> Check out the [workflow documentation](https://jupyter-releaser.readthedocs.io/en/latest/get_started/making_release_from_repo.html)
+> for more information.
+
+## Publishing to `conda-forge`
+
+If the package is not on conda forge yet, check the documentation to learn how to add it: https://conda-forge.org/docs/maintainer/adding_pkgs.html
+
+Otherwise a bot should pick up the new version publish to PyPI, and open a new PR on the feedstock repository automatically.

jupyterlab_file_browser_sorting_extension-1.0.4/babel.config.js

@@ -0,0 +1 @@
+module.exports = require('@jupyterlab/testutils/lib/babel.config');

jupyterlab_file_browser_sorting_extension-1.0.4/install.json

@@ -0,0 +1,5 @@
+{
+  "packageManager": "python",
+  "packageName": "jupyterlab_file_browser_sorting_extension",
+  "uninstallInstructions": "Use your Python package manager (pip, conda, etc.) to uninstall the package jupyterlab_file_browser_sorting_extension"
+}