dsh-better-left-sidebar 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 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.

package/README.en.md

@@ -0,0 +1,136 @@
+<!-- Writing guide: playbooks/reference/readme.md. Keep the same sections as README.md. -->
+
+# Better Left Sidebar
+
+[简体中文](README.md) | English
+
+[![CI](https://github.com/exoticknight/dsh-better-left-sidebar/actions/workflows/ci.yml/badge.svg)](https://github.com/exoticknight/dsh-better-left-sidebar/actions/workflows/ci.yml) [![License](https://img.shields.io/github/license/exoticknight/dsh-better-left-sidebar)](LICENSE) ![DSH](https://img.shields.io/badge/DSH-0.2.1--rc.3-blue) [![Maintained with RED](https://img.shields.io/badge/maintained_with-RED-C1121F)](https://github.com/exoticknight/red)
+
+<!-- Listing badges: add a row here only after each listing is confirmed. See playbooks/reference/badges.md. -->
+
+You need a cleaner DeepSeek Harness sidebar: keep workspaces and conversations in place, and expand full navigation only when you need it.
+
+<!-- client:start -->
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/exoticknight/dsh-better-left-sidebar/main/docs/images/sidebar-en.png" alt="Default layout: a narrow icon rail beside the open workspace and conversation list" width="49%" />
+  <img src="https://raw.githubusercontent.com/exoticknight/dsh-better-left-sidebar/main/docs/images/sidebar-hover-en.png" alt="Expanded navigation: full labels overlay the sidebar without moving the conversation pane" width="49%" />
+</div>
+
+<p align="center"><sub>Screenshots captured on DSH 0.2.1-rc.3.</sub></p>
+
+<!-- client:end -->
+
+## Features
+
+> `0.1.1` adds compact rail widgets, a configurable clock, grouped settings, and short-window navigation improvements.
+
+- **Keep conversations in the foreground**: workspaces and conversations stay in a dedicated wide pane; expanded navigation overlays it instead of squeezing the conversation area.
+- **Tuck global entry points out of the way**: place the brand, panels, and tools along a narrow left rail to leave more room for browsing sessions.
+- **Choose the interaction that fits**: hover or keyboard focus expands the rail by default; click mode pins it open and closes on another click, Escape, or an outside click.
+- **Shape the sidebar around your workflow**: reposition the brand, global navigation, and tools, then review the layout preview before applying it.
+- **Keep DSH's native actions**: New Session, panels, workspaces, settings, and footer tools keep their DSH entry points and behavior.
+- **See widgets in the compact rail**: the clock and widgets you choose sit at the bottom of the rail. In settings you can enable, disable, and reorder them, and change the clock's hour cycle, month/day, weekday, and time color.
+
+## Install
+
+The current source was verified on DSH `0.2.1-rc.3` in the `web` profile. See the [compatibility record](docs/compatibility.md) for the supported range.
+
+### Everyday users: npm release
+
+Install the exact version:
+
+```sh
+dsh plugin --profile web add dsh-better-left-sidebar@0.1.1
+```
+
+Restart DSH after installing.
+
+### Install from GitHub
+
+You can also install the matching GitHub Release:
+
+```sh
+dsh plugin --profile web add github:exoticknight/dsh-better-left-sidebar#v0.1.1
+```
+
+Restart DSH after installing.
+
+### Developers: local preview
+
+Run these commands from the repository. Development uses the isolated `.dsh-cli/` and `.dsh-dev/` directories; it does not modify your everyday DSH profile.
+
+```sh
+pnpm install
+```
+
+```sh
+pnpm dev:cli 0.2.1-rc.3
+```
+
+```sh
+pnpm dev
+```
+
+## Usage
+
+1. When enabled, the workspace and conversation list stay open; the far-left rail holds the DSH brand, global panels, and tools.
+2. In the default mode, hover over the rail or keyboard-focus a navigation item to reveal the full navigation. It closes after you leave it. Choose click mode in the plugin settings to pin or close the rail with the toggle button.
+3. Open **Plugins** in the sidebar, then **Better Left Sidebar** to configure expansion, animation, and region placement. Review the preview and select **Save settings** to apply changes. Copy follows DSH's active language; switch between Chinese and English in **Settings → General**.
+4. Use **[Compact widgets](docs/compact-widgets.md)** on the same settings page to manage the clock and compatible widgets. Expand **Display settings** under the clock to change its hour cycle, date, weekday, and time color. Date and Weekday can both be checked, and the **Effect preview** uses the same width as the rail. A widget that does not fit is marked **Hidden: not enough space**. New registrations are enabled by default, and their order and enablement are saved in the current profile.
+
+### Adapt your plugin to the compact rail
+
+Plugin authors can register display-only widgets by following the [compact widget guide](docs/compact-widgets.md). Saved preferences remain available while a plugin is unloaded.
+
+## Configuration
+
+After you select **Save settings**, layout preferences are stored in the current DSH profile's plugin configuration.
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| Expansion | `hover` | Expand on hover or keyboard focus; `click` pins the rail open with a toggle. |
+| Animation | `standard` | Choose soft, fast, or no animation. |
+| Brand | `navigation-top` | Place the brand at the top of the rail, at the top of the conversation pane, or hide it. |
+| Global navigation | `rail` | Keep global navigation in the rail or move it above conversations. |
+| Tools and status | `rail-bottom` | Keep tools at the bottom of the rail or move them below conversations. |
+| [Compact widgets](docs/compact-widgets.md) | Clock and new registrations enabled | Enable, disable, and reorder widgets in plugin settings; preferences are saved in the current DSH profile. |
+| Clock | 24-hour, month/day, primary color | 12-hour mode adds P or A after the time. Date and Weekday can both be checked. Choose Follow theme or Custom color; custom colors stay fixed across themes. The preview follows the draft, and the rail updates when you save. |
+
+## Update, roll back, remove
+
+To update to or reinstall `0.1.1`, remove the plugin and install the exact version:
+
+```sh
+dsh plugin --profile web remove dsh-better-left-sidebar
+```
+
+```sh
+dsh plugin --profile web add dsh-better-left-sidebar@0.1.1
+```
+
+To roll back, replace the version in the install command with `0.1.0`. [View GitHub Releases](https://github.com/exoticknight/dsh-better-left-sidebar/releases).
+
+Removing the plugin uninstalls its package; conversations and other plugins in the DSH profile remain.
+
+Developers can remove the plugin from the isolated preview profile:
+
+```sh
+pnpm dev:dsh --profile web plugin remove dsh-better-left-sidebar
+```
+
+## Privacy and data
+
+The plugin rearranges DSH's existing sidebar and uses DSH's built-in configuration service to save the layout, widget order and enablement, and clock display preferences you explicitly submit. It makes no direct network requests, reads no conversation content, writes no workspace files, stores no credentials, and collects no telemetry. DSH manages the profile's configuration storage and sync.
+
+## Compatibility
+
+Supports the `web` profile on DSH `>=0.2.0-rc.2 <0.2.2-0`. With Global navigation set to Above conversations, the global-navigation list scrolls independently to leave room for conversation content and footer tools; it shrinks first in short windows and can reach `0` at extreme heights. DSH's native “Standard mode” label can still truncate at a `567×626` viewport and the default `280px` or minimum `264px` sidebar width; widen the DSH sidebar if the full label matters. See the [compatibility record](docs/compatibility.md).
+
+## Development
+
+See [docs/development.md](docs/development.md), [CONTRIBUTING.md](CONTRIBUTING.md), and [AGENTS.md](AGENTS.md).
+
+## License
+
+[Apache License 2.0](LICENSE)

package/README.md

@@ -1,3 +1,136 @@
-# Temporary Holding Version
+<!-- 写作规范见 playbooks/reference/readme.md；与 README.en.md 保持相同章节。 -->
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# 更顺手的左侧栏
+
+简体中文 | [English](README.en.md)
+
+[![CI](https://github.com/exoticknight/dsh-better-left-sidebar/actions/workflows/ci.yml/badge.svg)](https://github.com/exoticknight/dsh-better-left-sidebar/actions/workflows/ci.yml) [![License](https://img.shields.io/github/license/exoticknight/dsh-better-left-sidebar)](LICENSE) ![DSH](https://img.shields.io/badge/DSH-0.2.1--rc.3-blue) [![Maintained with RED](https://img.shields.io/badge/maintained_with-RED-C1121F)](https://github.com/exoticknight/red)
+
+<!-- Listing badges: add a row here only after each listing is confirmed. See playbooks/reference/badges.md. -->
+
+你需要更清爽的左侧栏：让工作区与会话列表留在原位，完整导航只在需要时展开。
+
+<!-- client:start -->
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/exoticknight/dsh-better-left-sidebar/main/docs/images/sidebar.png" alt="默认布局：左侧窄图标栏与展开的工作区、会话列表并排" width="49%" />
+  <img src="https://raw.githubusercontent.com/exoticknight/dsh-better-left-sidebar/main/docs/images/sidebar-hover.png" alt="展开导航：完整入口覆盖在侧栏上，不会挤动对话区" width="49%" />
+</div>
+
+<p align="center"><sub>界面截图基于 DSH 0.2.1-rc.3。</sub></p>
+
+<!-- client:end -->
+
+## 功能
+
+> `0.1.1` 加入收起栏小组件、可配置时钟和分组设置，并包含小窗口导航改进。
+
+- **让会话始终留在主位**：工作区和会话列表保留在独立宽栏；展开导航时覆盖在其上，不会挤窄对话区。
+- **把全局入口收纳起来**：品牌、面板和工具可分布在左侧窄栏，空出更完整的会话浏览区域。
+- **鼠标、键盘、点击都能顺手操作**：默认悬停或聚焦时展开；也可切换为点击固定展开，并用再次点击、Esc 或外部点击收起。
+- **按自己的习惯安排侧栏**：调整品牌、全局导航和工具区的位置；保存前可查看布局效果预览。
+- **保留 DSH 原生操作**：新建会话、面板、工作区、设置和页脚工具仍使用 DSH 自己的入口与处理逻辑。
+- **在收起栏查看小组件**：时钟和你选择的插件小组件显示在导航栏底部。设置里可以启用、停用、排序，并调整时钟的小时制、月/日、星期和时间颜色。
+
+## 安装
+
+当前源码已在 DSH `0.2.1-rc.3` 的 `web` profile 验证；支持范围见[兼容性记录](docs/compatibility.md)。
+
+### 普通用户：npm 发布版
+
+安装精确版本：
+
+```sh
+dsh plugin --profile web add dsh-better-left-sidebar@0.1.1
+```
+
+安装后重启 DSH。
+
+### 从 GitHub 安装
+
+也可以安装对应版本的 GitHub Release：
+
+```sh
+dsh plugin --profile web add github:exoticknight/dsh-better-left-sidebar#v0.1.1
+```
+
+安装后重启 DSH。
+
+### 开发者：本地预览
+
+在仓库目录运行以下命令。开发版使用独立的 `.dsh-cli/` 与 `.dsh-dev/`，不会改动日常使用的 DSH profile。
+
+```sh
+pnpm install
+```
+
+```sh
+pnpm dev:cli 0.2.1-rc.3
+```
+
+```sh
+pnpm dev
+```
+
+## 使用
+
+1. 插件启用后，工作区与会话列表保持展开；最左侧窄栏放置 DSH 品牌、全局面板和工具入口。
+2. 默认将鼠标移入导航栏，或用键盘聚焦导航项，即可展开完整导航；离开导航区域且不再聚焦时自动收起。也可在插件设置中选择“点击展开”，通过点击固定或收起导航。
+3. 打开侧栏的“插件”页，进入“更顺手的左侧栏”配置展开方式、动画和区域位置；修改布局后先看预览，再点“保存设置”。文案跟随 DSH 当前语言；在“设置 → 通用设置”切换简体中文或 English。
+4. 在同一设置页的“[收起栏小组件](docs/compact-widgets.md)”管理时钟和适配插件的小组件。展开时钟的“显示设置”，可改小时制、日期、星期和时间颜色；日期与星期可同时勾选，旁边的“效果预览”与收起栏同宽。空间不足时，组件行会显示“空间不足，暂未显示”。首次注册默认启用，顺序与启用状态保存在当前 profile。
+
+### 让你的插件适配收起栏
+
+开发者可按[收起栏小组件指南](docs/compact-widgets.md)注册只展示信息的小组件。卸载或暂时未加载的插件仍会保留已保存的设置。
+
+## 配置
+
+布局偏好在点击“保存设置”后写入当前 DSH profile 的插件配置。
+
+| 选项 | 默认值 | 说明 |
+| --- | --- | --- |
+| 展开方式 | `hover` | 悬停或键盘聚焦时展开；也可选 `click`，由按钮固定展开。 |
+| 动画 | `standard` | 选择柔和、快速或关闭动画。 |
+| 品牌区 | `navigation-top` | 可放在导航栏顶部、对话面板顶部，或隐藏。 |
+| 全局导航 | `rail` | 可放在左侧导航栏，或移到对话列表上方。 |
+| 工具与状态 | `rail-bottom` | 可放在导航栏底部，或移到对话列表下方。 |
+| [收起栏小组件](docs/compact-widgets.md) | 时钟与已注册项目默认启用 | 在插件设置中启用、停用和排序；偏好保存在当前 DSH profile。 |
+| 时钟 | 24 小时，月/日，主色 | 小时制可选 12 小时，时间后加 P 或 A。日期和星期可以同时勾选。时间颜色可选“跟随主题”或“自定义颜色”，自定义颜色不随主题变化。预览跟随草稿，保存后收起栏才变。 |
+
+## 更新、回滚与卸载
+
+更新到 `0.1.1` 或重新安装时，先移除插件，再安装精确版本：
+
+```sh
+dsh plugin --profile web remove dsh-better-left-sidebar
+```
+
+```sh
+dsh plugin --profile web add dsh-better-left-sidebar@0.1.1
+```
+
+需要回滚时，将安装命令中的版本改为 `0.1.0`。[查看 GitHub Releases](https://github.com/exoticknight/dsh-better-left-sidebar/releases)。
+
+移除插件只会卸载插件包；当前 DSH profile 中的会话和其他插件会保留。
+
+开发者可从隔离的预览 profile 移除插件：
+
+```sh
+pnpm dev:dsh --profile web plugin remove dsh-better-left-sidebar
+```
+
+## 隐私与数据
+
+插件只调整 DSH 现有侧栏，并通过 DSH 内置配置服务保存你明确提交的布局、组件排序与启用状态、时钟显示偏好。插件不直接发起网络请求、不读取对话内容、不写入工作区文件、不保存凭据，也不采集遥测；配置的存储与同步由 DSH profile 管理。
+
+## 兼容性
+
+支持 DSH `>=0.2.0-rc.2 <0.2.2-0` 的 `web` profile。将“全局导航”设为“对话列表上方”时，导航列表独立滚动，为会话内容和底部工具留出空间；窗口变矮时导航区优先收缩，极端高度下可缩至 `0`。DSH 自带的“Standard mode”标签在 `567×626` 窗口和默认 `280px` 或最小 `264px` 侧栏宽度下仍可能被截断，可调宽 DSH 侧栏。详见[兼容性记录](docs/compatibility.md)。
+
+## 开发
+
+见 [docs/development.md](docs/development.md)、[CONTRIBUTING.md](CONTRIBUTING.md) 与 [AGENTS.md](AGENTS.md)。
+
+## 许可证
+
+[Apache License 2.0](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# Host activation for the DSH bundle. Add default config under `config:`;
+# users override it in their DSH settings.
+- insert:
+    - id: dsh-better-left-sidebar
+      name: dsh-better-left-sidebar
+      config:
+        animation: standard
+        expansion: hover
+        brandPosition: navigation-top
+        globalNavigationPosition: rail
+        toolsPosition: rail-bottom

package/icon.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <linearGradient id="background" x1="14" y1="12" x2="114" y2="118" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#2469F5"/>
+      <stop offset=".52" stop-color="#1D4FBA"/>
+      <stop offset="1" stop-color="#112448"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="120" height="120" rx="30" fill="url(#background)"/>
+
+  <rect x="69" y="28" width="36" height="70" rx="11" fill="#7899CA" opacity=".72"/>
+  <path d="M75 42h20M75 53h23M75 64h18M75 75h22" fill="none" stroke="#DCE8FA" stroke-linecap="round" stroke-width="3" opacity=".92"/>
+
+  <rect x="21" y="27" width="57" height="71" rx="12" fill="#F8FAFF"/>
+  <path d="M39.5 34v57" stroke="#DCE4F0" stroke-linecap="round" stroke-width="1.5"/>
+
+  <circle cx="30" cy="43" r="3.8" fill="#2563EB"/>
+  <circle cx="30" cy="61" r="3.7" fill="#9AA9BE"/>
+  <circle cx="30" cy="78" r="3.7" fill="#9AA9BE"/>
+
+  <rect x="44" y="36" width="29" height="13" rx="5.5" fill="#2563EB"/>
+  <path d="M48 42.5h20" fill="none" stroke="#BBD3FA" stroke-linecap="round" stroke-width="2.5"/>
+  <path d="M46 61h21M46 78h18" fill="none" stroke="#8998AF" stroke-linecap="round" stroke-width="3"/>
+</svg>