feat: implement intelligent auto-hide for dock with updated settings and translations (#73)

Author: leandromqrs

README.md

@@ -16,7 +16,7 @@ Aurora is split into independent modules, so you can enable only what you want.
 
 ### Dock & Panel
 
-- **Dock** - replaces the stock dash with a smart per-monitor dock with intellihide, edge reveal, optional always-visible mode, Trash, and removable drive shortcuts.
+- **Dock** - replaces the stock dash with a per-monitor dock that always auto-hides by default, with optional intellihide and always-visible modes, edge reveal, Trash, and removable drive shortcuts.
 - **Aurora Menu** - adds an Aurora panel menu with recent items, useful shortcuts, configurable panel icon, optional Activities button hiding, and a custom command slot.
 - **Volume Mixer** - adds per-application volume sliders to Quick Settings with fast access to Sound Settings.
 - **Low Battery Percentage** - uses GNOME's native battery percentage setting while the battery is discharging below 20%, without overriding users who already enabled it.

data/po/pt_BR.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: aurora-shell\n"
 "Report-Msgid-Bugs-To: https://github.com/luminusOS/aurora-shell/issues\n"
-"POT-Creation-Date: 2026-07-15 17:04-0300\n"
+"POT-Creation-Date: 2026-07-15 21:17-0300\n"
 "PO-Revision-Date: 2026-03-09 18:00-0300\n"
 "Last-Translator: Aurora Shell Contributors\n"
 "Language-Team: Portuguese (Brazil)\n"
@@ -179,12 +179,12 @@ msgstr ""
 "Mantém o dock sempre visível e reduz as janelas para que nunca o sobreponham"
 
 #: dist/dock/dock.manifest.js:19
-msgid "Always Auto-Hide Dock"
-msgstr "Sempre ocultar dock automaticamente"
+msgid "Intelligent Auto-Hide Dock"
+msgstr "Ocultação inteligente do dock"
 
 #: dist/dock/dock.manifest.js:20
-msgid "Keep the dock hidden until the pointer reaches the screen edge"
-msgstr "Mantém o dock oculto até o ponteiro alcançar a borda da tela"
+msgid "Keep the dock visible until a window overlaps it"
+msgstr "Mantém o dock visível até que uma janela sobreponha seu espaço"
 
 #: dist/dock/dock.manifest.js:25
 msgid "Show Dock on All Monitors"
@@ -736,6 +736,9 @@ msgstr "Alternador de Tema"
 msgid "Monitors and synchronizes GNOME color scheme"
 msgstr "Monitora e sincroniza o esquema de cores do GNOME"
 
+#~ msgid "Keep the dock hidden until the pointer reaches the screen edge"
+#~ msgstr "Mantém o dock oculto até o ponteiro alcançar a borda da tela"
+
 #~ msgid "When disabled, show the dock only on the primary monitor"
 #~ msgstr "Quando desativado, mostra o dock somente no monitor principal"
 

data/schemas/org.gnome.shell.extensions.aurora-shell.gschema.xml

@@ -76,10 +76,10 @@
       <summary>Always show dock</summary>
       <description>Keep the dock permanently visible and reserve screen space so windows never overlap it</description>
     </key>
-    <key name="dock-always-autohide" type="b">
+    <key name="dock-intellihide" type="b">
       <default>false</default>
-      <summary>Always auto-hide dock</summary>
-      <description>Keep the dock hidden until the pointer reaches the screen edge, regardless of window overlap</description>
+      <summary>Use intelligent dock auto-hide</summary>
+      <description>Keep the dock visible until a window overlaps its screen space</description>
     </key>
     <key name="dock-show-on-all-monitors" type="b">
       <default>false</default>

src/dev/dockDevTool.ts

@@ -30,7 +30,7 @@ export class DockDevTool {
       createDevToolSummary(
         this.iconName,
         dock
-          ? `Bindings: ${dock.bindings.length} · Always-show: ${dock.alwaysShow ? 'on' : 'off'} · Always-autohide: ${dock.alwaysAutoHide ? 'on' : 'off'}`
+          ? `Bindings: ${dock.bindings.length} · Always-show: ${dock.alwaysShow ? 'on' : 'off'} · Intellihide: ${dock.intellihideEnabled ? 'on' : 'off'}`
           : 'Dock disabled',
       ),
     );

src/dock/dock.manifest.ts

@@ -15,9 +15,9 @@ export const manifest: ModuleManifest = {
       type: 'switch',
     },
     {
-      key: 'dock-always-autohide',
-      title: _('Always Auto-Hide Dock'),
-      subtitle: _('Keep the dock hidden until the pointer reaches the screen edge'),
+      key: 'dock-intellihide',
+      title: _('Intelligent Auto-Hide Dock'),
+      subtitle: _('Keep the dock visible until a window overlaps it'),
       type: 'switch',
     },
     {

src/dock/dock.ts

@@ -38,7 +38,7 @@ export class Dock extends Module {
   private _pendingRebuild = false;
   private _dockSettings: any = null;
   private _alwaysShow = false;
-  private _alwaysAutoHide = false;
+  private _intellihideEnabled = false;
   private _showOnAllMonitors = false;
   private _showTrash = true;
   private _showExternalStorage = true;
@@ -51,17 +51,17 @@ export class Dock extends Module {
     this._lifecycle = new LifecycleScope();
     this._dockSettings = this.context.settings.getRawSettings();
     this._alwaysShow = this._dockSettings?.get_boolean('dock-always-show') ?? false;
-    this._alwaysAutoHide = this._dockSettings?.get_boolean('dock-always-autohide') ?? false;
-    if (this._alwaysShow && this._alwaysAutoHide) {
-      this._alwaysAutoHide = false;
-      this._dockSettings?.set_boolean('dock-always-autohide', false);
+    this._intellihideEnabled = this._dockSettings?.get_boolean('dock-intellihide') ?? false;
+    if (this._alwaysShow && this._intellihideEnabled) {
+      this._intellihideEnabled = false;
+      this._dockSettings?.set_boolean('dock-intellihide', false);
     }
     this._showOnAllMonitors = this._dockSettings?.get_boolean('dock-show-on-all-monitors') ?? false;
     this._showTrash = this._dockSettings?.get_boolean('dock-show-trash') ?? true;
     this._showExternalStorage =
       this._dockSettings?.get_boolean('dock-show-external-storage') ?? true;
     logger.debug(
-      `enable alwaysShow=${this._alwaysShow} alwaysAutoHide=${this._alwaysAutoHide} showOnAllMonitors=${this._showOnAllMonitors} showTrash=${this._showTrash} showExternalStorage=${this._showExternalStorage} monitors=${Main.layoutManager.monitors?.length ?? 0}`,
+      `enable alwaysShow=${this._alwaysShow} intellihide=${this._intellihideEnabled} showOnAllMonitors=${this._showOnAllMonitors} showTrash=${this._showTrash} showExternalStorage=${this._showExternalStorage} monitors=${Main.layoutManager.monitors?.length ?? 0}`,
       { prefix: LOG_PREFIX },
     );
 
@@ -98,16 +98,16 @@ export class Dock extends Module {
       'changed::dock-always-show',
       () => {
         this._alwaysShow = this._dockSettings?.get_boolean('dock-always-show') ?? false;
-        if (this._alwaysShow && this._alwaysAutoHide) {
-          this._dockSettings?.set_boolean('dock-always-autohide', false);
+        if (this._alwaysShow && this._intellihideEnabled) {
+          this._dockSettings?.set_boolean('dock-intellihide', false);
           return;
         }
         this._rebuildBindings();
       },
-      'changed::dock-always-autohide',
+      'changed::dock-intellihide',
       () => {
-        this._alwaysAutoHide = this._dockSettings?.get_boolean('dock-always-autohide') ?? false;
-        if (this._alwaysAutoHide && this._alwaysShow) {
+        this._intellihideEnabled = this._dockSettings?.get_boolean('dock-intellihide') ?? false;
+        if (this._intellihideEnabled && this._alwaysShow) {
           this._dockSettings?.set_boolean('dock-always-show', false);
           return;
         }
@@ -155,8 +155,8 @@ export class Dock extends Module {
     return this.context.settings.getBoolean('dock-always-show');
   }
 
-  get alwaysAutoHide(): boolean {
-    return this.context.settings.getBoolean('dock-always-autohide');
+  get intellihideEnabled(): boolean {
+    return this.context.settings.getBoolean('dock-intellihide');
   }
 
   toggleAlwaysShow(): boolean {
@@ -252,9 +252,9 @@ export class Dock extends Module {
   private _createBinding(monitor: DashBounds, monitorIndex: number): ManagedDockBinding | null {
     const mode = this._alwaysShow
       ? 'always-show'
-      : this._alwaysAutoHide
-        ? 'always-autohide'
-        : 'intellihide';
+      : this._intellihideEnabled
+        ? 'intellihide'
+        : 'always-autohide';
     // In always-show mode the strutActor must be added to uiGroup BEFORE the
     // container. Both are inserted via addChrome (→ uiGroup.add_child), so the
     // one added first sits lower in Z-order. The DnD system uses PickMode.ALL
@@ -316,7 +316,7 @@ export class Dock extends Module {
     } else {
       binding.hotArea = this._createHotArea(binding, monitor);
 
-      if (this._alwaysAutoHide) {
+      if (!this._intellihideEnabled) {
         dash.forceAutoHide(false);
         this._enableHotAreaWhenDockHidden(binding);
         return binding;
@@ -636,11 +636,11 @@ export class Dock extends Module {
         this._updateWorkArea(binding);
         if (this._alwaysShow) {
           binding.dash.blockAutoHide(true);
-        } else if (this._alwaysAutoHide) {
+        } else if (this._intellihideEnabled) {
+          binding.intellihide?.refresh('overview-hidden', true);
+        } else {
           binding.dash.forceAutoHide(false);
           this._enableHotAreaWhenDockHidden(binding);
-        } else {
-          binding.intellihide?.refresh('overview-hidden', true);
         }
       }
     });

tests/shell/auroraDock.js

@@ -138,12 +138,12 @@ export async function run() {
   const originalShowTrash = settings.get_boolean('dock-show-trash');
   const originalShowExternalStorage = settings.get_boolean('dock-show-external-storage');
   const originalAlwaysShow = settings.get_boolean('dock-always-show');
-  const originalAlwaysAutoHide = settings.get_boolean('dock-always-autohide');
+  const originalIntellihide = settings.get_boolean('dock-intellihide');
   const originalShowOnAllMonitors = settings.get_boolean('dock-show-on-all-monitors');
   settings.set_boolean('dock-show-trash', true);
   settings.set_boolean('dock-show-external-storage', false);
   settings.set_boolean('dock-always-show', false);
-  settings.set_boolean('dock-always-autohide', false);
+  settings.set_boolean('dock-intellihide', true);
   settings.set_boolean('dock-show-on-all-monitors', false);
 
   await Scripting.waitLeisure();
@@ -754,7 +754,7 @@ export async function run() {
 
   // Always auto-hide must bypass intellihide completely: with no overlap
   // decision involved, it starts hidden and only appears through the hot area.
-  settings.set_boolean('dock-always-autohide', true);
+  settings.set_boolean('dock-intellihide', false);
   await Scripting.waitLeisure();
   await Scripting.sleep(400);
   const alwaysAutoHideBinding = dock.bindings.find(
@@ -804,7 +804,7 @@ export async function run() {
   settings.set_boolean('dock-show-trash', originalShowTrash);
   settings.set_boolean('dock-show-external-storage', originalShowExternalStorage);
   settings.set_boolean('dock-always-show', originalAlwaysShow);
-  settings.set_boolean('dock-always-autohide', originalAlwaysAutoHide);
+  settings.set_boolean('dock-intellihide', originalIntellihide);
   settings.set_boolean('dock-show-on-all-monitors', originalShowOnAllMonitors);
   settings.set_boolean('module-dock', originalValue);
   await Scripting.waitLeisure();

tests/unit/schema.test.ts

@@ -229,6 +229,6 @@ test('schema — Dock defaults to the primary monitor only', () => {
   assert.equal(schemaDefault('dock-show-on-all-monitors'), 'false');
 });
 
-test('schema — Dock always auto-hide is disabled by default', () => {
-  assert.equal(schemaDefault('dock-always-autohide'), 'false');
+test('schema — Dock uses always auto-hide by default', () => {
+  assert.equal(schemaDefault('dock-intellihide'), 'false');
 });