@hnode/tidy 0.20.0 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -36,7 +36,7 @@ Tidy는 Ubuntu GNOME과 macOS에서 창을 배치합니다. GNOME에서는 Shell
36
36
  | 사용자 지정 단축키 | Super+Alt 조합으로 절반·¼·⅓·⅔ 배치를 지정하고 단축키를 바꿀 수 있습니다. |
37
37
  | 다중 모니터 | 같은 방향키를 반복하면 해당 방향의 모니터로 이동합니다. 선택기 크기도 모니터에 맞춰 조절합니다. |
38
38
  | 함께 크기 조절 | 타일 창의 공유 경계를 끌면 맞닿은 창을 함께 조절합니다. 기본값은 켬입니다. |
39
- | 남은 공간 채우기 | 빈 영역에 실행 중인 앱 아이콘을 표시해 다음 창을 고릅니다. 기본값은 끔입니다. |
39
+ | 남은 공간 채우기 | 빈 영역에 실제 창의 축소 미리보기와 제목을 표시합니다. 같은 앱의 여러 창도 각각 고를 수 있습니다. 기본값은 끔입니다. |
40
40
  | 크기와 간격 설정 | 일반 선택기와 창 보기 선택기의 크기, 창 사이 간격을 조절합니다. |
41
41
 
42
42
  선택기의 100%는 이전 버전의 115% 크기입니다. 기존에 저장한 크기는 새 기준으로 환산합니다. 상하 분할과 전체화면 카드는 제거하고, 동일한 너비의 3열 오른쪽에 **¼ · ½ · ¼** 배치를 제공합니다. 최대화 단축키와 화면 상단 가장자리의 최대화 동작은 계속 사용할 수 있습니다. 자동 크기 조절은 16인치 내장 화면의 기준 크기를 유지하며, 32인치 외장 화면에서는 이전 자동 크기의 약 80%를 새 100%로 사용합니다.
@@ -106,7 +106,7 @@ Git 대신 [Download ZIP](https://github.com/hojin-v/Tidy/archive/refs/heads/mai
106
106
 
107
107
  창 보기에서는 창 미리보기를 잡고 움직이는 즉시 작아지며, 놓거나 취소하면 원래 크기로 돌아옵니다. 배치 칸에 놓으면 작은 미리보기에서 배치 위치로 이어집니다.
108
108
 
109
- 남은 공간의 창 선택 옵션을 켰다면 빈 영역의 앱 아이콘을 선택하세요. 현재 창이나 다른 영역을 클릭하거나 Esc를 누르면 추가 배치 없이 마칩니다.
109
+ 남은 공간의 창 선택 옵션을 켰다면 빈 영역에 표시되는 실제 창의 축소 미리보기와 제목을 보고 원하는 창을 선택하세요. 같은 앱의 여러 창도 각각 표시하며, 창이 많으면 영역 안에서 스크롤할 수 있습니다. 최소화된 창은 선택하면 복원해서 배치합니다. 현재 창이나 다른 영역을 클릭하거나 Esc를 누르면 추가 배치 없이 마칩니다.
110
110
 
111
111
  선택기는 Ubuntu Dock의 애니메이션 시간과 곡선을 따라 상단에서 미끄러져 나옵니다. 선택 영역을 벗어나면 창이 원래 크기로 돌아오며, 놓으면 작은 미리보기에서 배치 위치로 이어집니다.
112
112
 
@@ -146,7 +146,7 @@ macOS에서는 `tidy prefs` 또는 메뉴 막대 아이콘으로 설정을 엽
146
146
  - **모니터에 맞춰 선택기 크기 자동 조절**: 내장 화면을 기준으로 큰 외장 모니터의 선택기를 적당히 키웁니다. 기본값은 켬입니다.
147
147
  - **배치 선택기 크기 / 창 보기 선택기 크기**: 기본 크기는 같으며, 창 보기의 크기를 별도로 조절할 수 있습니다.
148
148
  - **선택기 너비에 인식 범위 맞추기**: 기본값은 켬입니다. 모니터별 선택기 너비에 맞춰 인식 영역과 드래그 안내를 조절합니다. 끄면 기존 사용자 지정 너비를 사용합니다.
149
- - **남은 공간의 창 선택**: 배치 후 빈 영역에 앱 아이콘을 표시합니다. 기본값은 끔입니다.
149
+ - **남은 공간의 창 선택**: 배치 후 빈 영역에 창별 축소 미리보기와 제목을 표시합니다. 기본값은 끔입니다.
150
150
  - **최대화 버튼에 마우스를 올리면 배치 선택기 표시**: 최대화·복원 버튼에서 선택기를 엽니다. 기본값은 켬이며 상단 드래그 선택기와 별도로 끌 수 있습니다.
151
151
 
152
152
  CLI에서도 설정이나 상태를 확인할 수 있습니다.
@@ -159,7 +159,7 @@ tidy status
159
159
  CLI 없이 설치된 관리 도구를 직접 실행할 수도 있습니다. 원본 소스 폴더는 필요하지 않습니다.
160
160
 
161
161
  ```bash
162
- tidy_manager="${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/winubun@winubun.local/scripts/manage.py"
162
+ tidy_manager="${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/tidy@hnode/scripts/manage.py"
163
163
  /usr/bin/python3 "$tidy_manager" prefs
164
164
  /usr/bin/python3 "$tidy_manager" status
165
165
  ```
@@ -182,6 +182,8 @@ git pull --ff-only
182
182
 
183
183
  확장 코드의 버전이 바뀌면 로그아웃 후 다시 로그인하세요. GNOME은 로그인 중 불러온 JavaScript를 캐시하므로 확장을 껐다 켜는 것만으로는 새 코드가 적용되지 않습니다. 기존 설정과 단축키는 유지합니다.
184
184
 
185
+ 설치·업데이트 완료 시 재로그인 안내를 표시합니다. 적용을 기다리는 경우에는 **[재로그인 필요]** 문구가 나오며, 다음 로그인에서 자동으로 활성화됩니다. 재로그인 전에는 `tidy status`에서도 안내를 확인할 수 있습니다. 같은 확장 코드가 이미 로드되어 있으면 이번에는 재로그인이 필요하지 않다고 안내합니다.
186
+
185
187
  ## Uninstall
186
188
 
187
189
  확장을 먼저 제거하고 npm CLI를 제거합니다.
@@ -196,14 +198,14 @@ npx로 설치했다면 `npx @hnode/tidy@latest uninstall`을 사용하세요. **
196
198
  CLI가 없어도 어느 폴더에서든 설치된 도구로 제거할 수 있습니다.
197
199
 
198
200
  ```bash
199
- /usr/bin/python3 "${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/winubun@winubun.local/scripts/manage.py" uninstall
201
+ /usr/bin/python3 "${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/tidy@hnode/scripts/manage.py" uninstall
200
202
  ```
201
203
 
202
204
  확장과 앱 실행기를 제거하고, 변경했던 GNOME 설정과 기존 타일링 확장 상태를 복원합니다. Tidy의 사용자 설정과 단축키는 재설치를 위해 보관합니다.
203
205
 
204
206
  기존 타일링 확장의 사용자 설치본을 삭제하여 현재 세션에서 인식되지 않는 경우, 남아 있는 시스템 원본을 다음 로그인에 활성화하도록 설정하고 Tidy 제거를 완료합니다. 이 경우 출력 안내에 따라 다시 로그인하세요. 이전 확장이 시스템에서도 제거됐다면 재설치하지 않습니다.
205
207
 
206
- 경로의 `winubun`은 기존 설정과 고정한 실행기의 호환성을 위해 유지한 내부 이름입니다.
208
+ 확장 관리자에 표시되는 UUID는 `tidy@hnode`입니다. `tidy update`는 기존 `winubun@winubun.local` 또는 `tidy@hnode.dev` 설치를 새 UUID로 이전합니다. 기존 설정과 단축키는 유지하며, 설정 저장소·상태 폴더·고정한 실행기 파일의 `winubun` 이름은 호환성을 위해 유지합니다.
207
209
 
208
210
  ## Notes
209
211
 
package/bin/tidy.js CHANGED
@@ -11,6 +11,7 @@ const root = dirname(dirname(fileURLToPath(import.meta.url)));
11
11
  const metadata = JSON.parse(readFileSync(join(root, 'metadata.json'), 'utf8'));
12
12
  const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
13
13
  const catalogs = JSON.parse(readFileSync(join(root, 'lib/translations.json'), 'utf8'));
14
+ const legacyUuids = ['tidy@hnode.dev', 'winubun@winubun.local'];
14
15
  const commands = ['install', 'update', 'uninstall', 'prefs', 'status', 'doctor'];
15
16
 
16
17
  export function main({args = process.argv.slice(2), env = process.env, platform = process.platform,
@@ -68,13 +69,15 @@ export function main({args = process.argv.slice(2), env = process.env, platform
68
69
  return 0;
69
70
  }
70
71
  }
71
- const installed = join(env.XDG_DATA_HOME || join(homedir(), '.local/share'),
72
- 'gnome-shell/extensions', metadata.uuid, 'scripts/manage.py');
73
- if (['prefs', 'status'].includes(command) && !existsSync(installed)) {
72
+ const data = env.XDG_DATA_HOME || join(homedir(), '.local/share');
73
+ const installed = [metadata.uuid, ...legacyUuids]
74
+ .map(uuid => join(data, 'gnome-shell/extensions', uuid, 'scripts/manage.py'))
75
+ .find(path => existsSync(path));
76
+ if (['prefs', 'status'].includes(command) && !installed) {
74
77
  error(_('Tidy is not installed. Run tidy install first.'));
75
78
  return 1;
76
79
  }
77
- const manager = installing || !existsSync(installed) ? join(packageRoot, 'scripts/manage.py') : installed;
80
+ const manager = installing || !installed ? join(packageRoot, 'scripts/manage.py') : installed;
78
81
  const parameters = [manager, installing ? 'install' : command];
79
82
  if (installing) {
80
83
  const archive = join(packageRoot, 'dist', `${metadata.uuid}.shell-extension.zip`);
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "tidy-desktop",
3
- "version": "0.20.0",
3
+ "version": "0.20.2",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "tidy-desktop",
9
- "version": "0.20.0",
9
+ "version": "0.20.2",
10
10
  "dependencies": {
11
11
  "electron": "45.2.3"
12
12
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tidy-desktop",
3
- "version": "0.20.0",
3
+ "version": "0.20.2",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "main": "main.js",
@@ -16,7 +16,7 @@ npm run check
16
16
  npm run test:package
17
17
  ```
18
18
 
19
- 빌드 결과는 `dist/winubun@winubun.local.shell-extension.zip`입니다. 런타임 소스, 컴파일한 스키마, 설치·복구 도구와 GPL 라이선스 파일을 포함합니다.
19
+ 빌드 결과는 `dist/tidy@hnode.shell-extension.zip`입니다. 런타임 소스, 컴파일한 스키마, 설치·복구 도구와 GPL 라이선스 파일을 포함합니다.
20
20
 
21
21
  npm 배포 이름은 `@hnode/tidy`이고 실행 파일은 `bin/tidy.js`입니다. `npm pack`은 `prepack`에서 Node.js로 확장 ZIP을 빌드합니다. 이 빌드는 macOS에서도 Python 없이 동작합니다. GLib 컴파일러가 없는 환경에서는 XML 스키마를 포함하고 GNOME 설치 시 컴파일합니다. 사용자 설치 시에는 이 ZIP을 사용하므로 npm 패키지 경로가 읽기 전용이어도 됩니다. 게시 절차와 tarball 검증은 [Releasing](RELEASING.md)을 참고하세요.
22
22
 
@@ -27,6 +27,8 @@ npm 배포 이름은 `@hnode/tidy`이고 실행 파일은 `bin/tidy.js`입니다
27
27
  ```bash
28
28
  GSETTINGS_BACKEND=memory GSETTINGS_SCHEMA_DIR="$PWD/schemas" gjs -m tests/lease-smoke.js
29
29
  /usr/bin/python3 scripts/test-shell.py
30
+ /usr/bin/python3 scripts/test-shell.py --migration-only
31
+ TIDY_TEST_LEGACY_UUID=tidy@hnode.dev /usr/bin/python3 scripts/test-shell.py --migration-only
30
32
  ```
31
33
 
32
34
  Shell 통합 테스트는 GNOME 50의 `gnome-shell-test-tool`과 가상 모니터를 지원하는 그래픽 환경이 필요합니다. 별도 D-Bus, 런타임 디렉터리, 설정 저장소와 헤드리스 Wayland 세션에서 동작합니다.
@@ -46,11 +48,12 @@ Ubuntu Dock이 설치된 환경에서는 `TIDY_TEST_UBUNTU_DOCK=1 /usr/bin/pytho
46
48
  - Ubuntu Dock 설정을 따르는 선택기 슬라이드, 드래그 안내와 선택기 너비에 맞춘 감지 영역
47
49
  - 실제 창 크기를 유지하는 축소 미리보기, 이동 추적·취소와 배치 애니메이션 연결
48
50
  - 창·앱 보기의 드래그 즉시 축소, 포인터 고정·복귀와 작은 상태에서의 배치 전환
49
- - 남은 공간의 앱 선택, 빈 곳 클릭·Esc 취소와 최소화된 창 복원
51
+ - 남은 공간의 창별 실시간 미리보기·제목, 같은 앱의 여러 창 선택·배치, 창 추가·종료·크기 변경 반영, 빈 곳 클릭·Esc 취소와 최소화된 창 복원
50
52
  - 원본 소스 폴더를 삭제한 뒤 설치 도구 실행·설정 복구·제거
51
53
  - 제거 전 확장 종료 확인, 기존 확장 복원 상태 검증과 삭제된 사용자 확장의 시스템 원본을 다음 로그인에 복원
52
54
  - npm tarball 전역 설치, 읽기 전용 패키지, CLI 언어·의존성 검사와 설치된 복구 도구 연결
53
55
  - 확장 재활성화·빠른 켜기/끄기, 예약 작업 취소와 데스크톱 설정 복원
56
+ - `winubun@winubun.local`에서 `tidy@hnode`로 이전, 이전 확장 종료·제거와 설정 유지, 업데이트 후 재로그인 안내
54
57
  - 상단 한 행 선택기와 최대화 버튼 3열 × 2행 선택기의 개별 배치·클릭·드래그
55
58
  - Super+A 앱 목록에서 선택기·드롭 영역·추가 검색 여백 해제와 창 보기 복귀
56
59
  - 중첩된 Chromium 제목 표시줄, 한국어 ‘복구’ 버튼, 창 그림자를 포함한 접근성 좌표 변환
@@ -65,7 +68,7 @@ Ubuntu Dock이 설치된 환경에서는 `TIDY_TEST_UBUNTU_DOCK=1 /usr/bin/pytho
65
68
 
66
69
  | 경로 | 용도 |
67
70
  | --- | --- |
68
- | `~/.local/share/gnome-shell/extensions/winubun@winubun.local/` | 확장과 설치된 관리 도구 |
71
+ | `~/.local/share/gnome-shell/extensions/tidy@hnode/` | 확장과 설치된 관리 도구 |
69
72
  | `~/.local/share/applications/winubun.desktop` | Tidy 실행기 |
70
73
  | `~/.local/state/winubun/launcher.log` | 실행 오류 |
71
74
  | `~/.local/state/winubun/preferences.log` | 설정 앱 로그 |
@@ -73,7 +76,7 @@ Ubuntu Dock이 설치된 환경에서는 `TIDY_TEST_UBUNTU_DOCK=1 /usr/bin/pytho
73
76
 
74
77
  ```bash
75
78
  gnome-shell --version
76
- gnome-extensions info winubun@winubun.local
79
+ gnome-extensions info tidy@hnode
77
80
  journalctl --user -b --no-pager -g 'Tidy|winubun|JS ERROR'
78
81
  ```
79
82
 
package/docs/MACOS.md CHANGED
@@ -18,7 +18,7 @@ tidy doctor
18
18
  tidy install
19
19
  ```
20
20
 
21
- 0.20.0 배포본을 버전 고정으로 테스트하는 절차는 [배포본 Mac 테스트](RELEASING.md#test-the-published-package-on-mac)에 있습니다. 전역 설치 없이 `npx --yes @hnode/tidy@0.20.0 install`로도 설치할 수 있습니다.
21
+ 0.20.2 배포본을 버전 고정으로 테스트하는 절차는 [배포본 Mac 테스트](RELEASING.md#test-the-published-package-on-mac)에 있습니다. 전역 설치 없이 `npx --yes @hnode/tidy@0.20.2 install`로도 설치할 수 있습니다.
22
22
 
23
23
  소스의 변경 사항을 사용하려면 저장소에서 실행하세요.
24
24
 
@@ -56,7 +56,7 @@ tidy uninstall
56
56
 
57
57
  6가지 배치 선택기, 상단 드래그·가장자리 배치, 사용자 지정 단축키, 다중 모니터 이동·순환, 최대화·복귀, 창 간격, 한국어·영어 설정, 로그인 자동 실행을 제공합니다. Dock과 메뉴 막대를 제외한 작업 영역을 사용합니다.
58
58
 
59
- GNOME의 Super 창 보기 연동, 최대화 버튼 호버, 축소 드래그 애니메이션, 함께 크기 조절, 남은 공간의 앱 선택은 GNOME판 기능입니다. macOS판에는 별도 창 목록이 없습니다. 창 이동·크기 변경을 막는 앱과 전체 화면 창은 배치 대상에서 제외하며, 앱의 최소 크기 때문에 요청한 배치보다 커질 수 있습니다.
59
+ GNOME의 Super 창 보기 연동, 최대화 버튼 호버, 축소 드래그 애니메이션, 함께 크기 조절, 남은 공간의 창 선택은 GNOME판 기능입니다. macOS판에는 별도 창 목록이 없습니다. 창 이동·크기 변경을 막는 앱과 전체 화면 창은 배치 대상에서 제외하며, 앱의 최소 크기 때문에 요청한 배치보다 커질 수 있습니다.
60
60
 
61
61
  Ubuntu 개발 환경에서 공통 계산, macOS 명령 분기, 네이티브 통신 대역, 설치·복구 및 npm 패키지를 검증했습니다. 실제 Chromium에서 선택기와 한국어 설정 UI도 검사했습니다. **실제 Mac에서의 창 조작은 실기 검증 전입니다.** CI는 Ubuntu와 macOS의 Node 테스트·패키지 빌드, macOS Swift 컴파일·읽기 전용 네이티브 프로토콜·UI 검사를 수행하도록 구성되어 있습니다.
62
62
 
package/docs/README.en.md CHANGED
@@ -36,7 +36,7 @@ The table below describes the GNOME edition. macOS provides the six-layout picke
36
36
  | Custom shortcuts | Use Super+Alt for halves, quarters, thirds and two-thirds; customize the bindings in settings. |
37
37
  | Multiple monitors | Repeat an arrow shortcut to move to the monitor in that direction, including above and below. Picker size adapts to each monitor. |
38
38
  | Linked resizing | Drag shared boundaries to resize adjacent tiled windows together. Enabled by default. |
39
- | Optional snap assist | Choose running app icons inside empty regions to fill the remaining space. Disabled by default. |
39
+ | Optional snap assist | Choose live window previews with titles inside empty regions. Multiple windows of the same app appear separately. Disabled by default. |
40
40
  | Size and spacing | Adjust picker sizes and window gaps, including a separate overview picker size. |
41
41
 
42
42
  The 100% picker size now matches the previous 115% size. Saved sizes are converted to the new reference. Top/bottom and maximize cards are removed, and a **¼ · ½ · ¼** layout sits immediately to the right of equal thirds. Maximize shortcuts and top-edge maximization remain available. Automatic sizing preserves the 16-inch built-in reference; on a 32-inch external monitor, the new 100% matches approximately 80% of the previous automatic size.
@@ -112,7 +112,7 @@ Press **Super** to open window overview and the single-row layout picker togethe
112
112
 
113
113
  Window previews shrink as soon as you start dragging in window overview, and return to their original size on release or cancellation. Dropping a window into a layout continues directly from the miniature to its final placement.
114
114
 
115
- With snap assist enabled, select an app icon in an empty region to tile its window there. Click the current window or another area, or press Esc, to finish without any additional placements.
115
+ With snap assist enabled, select a live window preview in an empty region to tile that exact window there. Each window has its own preview and title, including multiple windows of the same app. Scroll within the region if there are many windows. Minimized windows are restored only when selected. Click the current window or another area, or press Esc, to finish without any additional placements.
116
116
 
117
117
  The picker slides down using Ubuntu Dock's animation duration and curve. Leaving the selection area restores the window's size; dropping onto a cell animates directly from the miniature to its destination.
118
118
 
@@ -148,7 +148,7 @@ Open **Tidy** from the application list, or choose **Settings and shortcuts…**
148
148
  - **Adapt picker size to each monitor** keeps the built-in display as the baseline and gently enlarges the picker on larger external displays. Enabled by default.
149
149
  - **Layout picker size / Overview picker size** default to equal sizes. The overview picker has its own relative size setting.
150
150
  - **Match activation width to picker** keeps the activation area and drag hint aligned with the picker on each monitor. Enabled by default; turn it off to use your custom width.
151
- - **Choose windows for the remaining space** shows running app icons in empty layout regions. Disabled by default.
151
+ - **Choose windows for the remaining space** shows live window previews and titles in empty layout regions. Disabled by default.
152
152
 
153
153
  Open settings or check status from the CLI:
154
154
 
@@ -160,7 +160,7 @@ tidy status
160
160
  You can also use the installed management tool directly. The source folder is not needed:
161
161
 
162
162
  ```bash
163
- tidy_manager="${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/winubun@winubun.local/scripts/manage.py"
163
+ tidy_manager="${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/tidy@hnode/scripts/manage.py"
164
164
  /usr/bin/python3 "$tidy_manager" prefs
165
165
  /usr/bin/python3 "$tidy_manager" status
166
166
  ```
@@ -183,6 +183,8 @@ git pull --ff-only
183
183
 
184
184
  Log out and back in when the extension code version changes. GNOME caches JavaScript for the session, so toggling the extension does not reload it. Existing settings and shortcuts are preserved.
185
185
 
186
+ Installation and updates always show a login notice. If the new code is waiting to be applied, **[Login required]** tells you to log out and back in; Tidy starts automatically at the next login. `tidy status` also shows the reminder until the new code is registered. Reinstalling code that is already loaded explains that no logout is needed this time.
187
+
186
188
  ## Uninstall
187
189
 
188
190
  Remove the extension first, then the npm CLI:
@@ -197,14 +199,14 @@ For npx installations, use `npx @hnode/tidy@latest uninstall`. **Removing only t
197
199
  Without the CLI, run the installed tool from any directory:
198
200
 
199
201
  ```bash
200
- /usr/bin/python3 "${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/winubun@winubun.local/scripts/manage.py" uninstall
202
+ /usr/bin/python3 "${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/tidy@hnode/scripts/manage.py" uninstall
201
203
  ```
202
204
 
203
205
  This removes the extension and application launcher and restores the GNOME settings and competing tiling-extension state that Tidy changed. Tidy's custom settings and shortcuts are kept for reinstallation.
204
206
 
205
207
  If removing a user-installed tiling extension made its UUID unavailable in the current session, the uninstaller enables any remaining system copy for the next login and completes Tidy removal. Log out and back in when prompted. An extension removed from the system entirely is not reinstalled.
206
208
 
207
- The `winubun` path is a stable internal name retained for compatibility with existing settings and pinned launchers.
209
+ The UUID shown in extension managers is `tidy@hnode`. `tidy update` migrates an existing `winubun@winubun.local` or `tidy@hnode.dev` installation to the new UUID and preserves settings and shortcuts. The settings schema, state directory and launcher retain their internal `winubun` names for compatibility.
208
210
 
209
211
  ## Notes
210
212
 
package/docs/RELEASING.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Tidy는 **@hnode/tidy**라는 공개 npm 패키지로 배포합니다. `tidy` CLI, GNOME 확장 ZIP과 macOS 데스크톱 앱 소스를 포함합니다. 루트 패키지에는 런타임 npm 의존성이 없고, macOS의 명시적 `tidy install` 시 별도 사용자 폴더에 고정 버전의 Electron을 설치합니다. 확장 ZIP과 데스크톱 설치에는 GPL 소스와 라이선스 파일을 포함합니다.
4
4
 
5
- 현재 배포 준비 버전은 **0.20.0**입니다. macOS 설치·업데이트·제거, 메뉴 막대 선택기, Control+Option 단축키와 Swift Accessibility 창 제어를 포함합니다. GNOME 확장 내부 버전은 **22**를 유지합니다. Mac의 실제 창 조작은 배포본을 받은 뒤 검증하며, 자동 검사 통과와 구분합니다.
5
+ 현재 배포 준비 버전은 **0.20.2**입니다. macOS 설치·업데이트·제거, 메뉴 막대 선택기, Control+Option 단축키와 Swift Accessibility 창 제어를 포함합니다. GNOME의 남은 공간 선택기는 창별 실시간 미리보기와 제목을 표시하며, 확장 UUID는 `tidy@hnode`, 내부 버전은 **24**입니다. 기존 UUID에서 설정을 유지해 이전하며, 설치·업데이트 완료 시 재로그인 필요 여부를 안내합니다. Mac의 실제 창 조작은 배포본을 받은 뒤 검증하며, 자동 검사 통과와 구분합니다.
6
6
 
7
7
  ## Prepare
8
8
 
@@ -15,8 +15,8 @@ npm run check
15
15
  npm run test:package
16
16
  npm pack --dry-run
17
17
  npm pack --pack-destination dist
18
- node tests/npm-package-smoke.js dist/hnode-tidy-0.20.0.tgz
19
- sha256sum dist/hnode-tidy-0.20.0.tgz
18
+ node tests/npm-package-smoke.js dist/hnode-tidy-0.20.2.tgz
19
+ sha256sum dist/hnode-tidy-0.20.2.tgz
20
20
  ```
21
21
 
22
22
  `prepack`이 Node.js로 최신 소스의 확장 ZIP을 다시 빌드합니다. GNOME 배포용 tarball은 `glib-compile-schemas`가 있는 Linux에서 빌드해 컴파일한 스키마까지 검증하세요. macOS에서는 GLib 없이 소스 스키마를 포함한 ZIP을 만들 수 있습니다. 공개 파일은 `package.json`의 `files` 목록으로 제한합니다. `desktop/native/macos.swift`, UI와 공통 `lib/layouts.js`가 포함되는지 확인하세요. 로그, 테스트, `.npmrc`, 캐시, `node_modules`는 포함하지 않습니다. npm 패키지 설치 자체는 데스크톱 설정을 바꾸지 않으며 `postinstall`은 사용하지 않습니다.
@@ -37,8 +37,8 @@ TIDY_TEST_UBUNTU_DOCK=1 /usr/bin/python3 scripts/test-shell.py
37
37
  ```bash
38
38
  npm login --registry=https://registry.npmjs.org/
39
39
  npm whoami --registry=https://registry.npmjs.org/
40
- npm publish ./dist/hnode-tidy-0.20.0.tgz --access public --tag latest
41
- npm view @hnode/tidy@0.20.0 version os dist.integrity --json
40
+ npm publish ./dist/hnode-tidy-0.20.2.tgz --access public --tag latest
41
+ npm view @hnode/tidy@0.20.2 version os dist.integrity --json
42
42
  npm view @hnode/tidy dist-tags --json
43
43
  ```
44
44
 
@@ -49,16 +49,16 @@ npm이 요청하는 브라우저 로그인·2FA를 완료하세요. 같은 버
49
49
  Node.js 22.12 이상과 Xcode Command Line Tools가 필요합니다. 컴파일러가 없다면 `xcode-select --install`로 설치를 완료한 다음 진행하세요. 게시한 버전을 명시해 이전 `latest`나 전역 설치본과 혼동하지 않도록 합니다.
50
50
 
51
51
  ```sh
52
- npx --yes @hnode/tidy@0.20.0 --version
53
- npx --yes @hnode/tidy@0.20.0 doctor
54
- npx --yes @hnode/tidy@0.20.0 install
55
- npx --yes @hnode/tidy@0.20.0 status
52
+ npx --yes @hnode/tidy@0.20.2 --version
53
+ npx --yes @hnode/tidy@0.20.2 doctor
54
+ npx --yes @hnode/tidy@0.20.2 install
55
+ npx --yes @hnode/tidy@0.20.2 status
56
56
  ```
57
57
 
58
- 첫 명령은 `0.20.0`을 출력해야 합니다. **시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용**에서 Tidy를 허용하세요. 메뉴 막대에서 Tidy를 종료하고 다음 명령으로 다시 실행하면 새 권한을 적용합니다.
58
+ 첫 명령은 `0.20.2`를 출력해야 합니다. **시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용**에서 Tidy를 허용하세요. 메뉴 막대에서 Tidy를 종료하고 다음 명령으로 다시 실행하면 새 권한을 적용합니다.
59
59
 
60
60
  ```sh
61
- npx --yes @hnode/tidy@0.20.0 prefs
61
+ npx --yes @hnode/tidy@0.20.2 prefs
62
62
  ```
63
63
 
64
64
  TextEdit나 브라우저 같은 일반 창을 선택한 뒤 확인하세요.
@@ -71,11 +71,11 @@ TextEdit나 브라우저 같은 일반 창을 선택한 뒤 확인하세요.
71
71
  업데이트와 제거도 같은 공개 버전으로 확인할 수 있습니다.
72
72
 
73
73
  ```sh
74
- npx --yes @hnode/tidy@0.20.0 update
75
- npx --yes @hnode/tidy@0.20.0 uninstall
74
+ npx --yes @hnode/tidy@0.20.2 update
75
+ npx --yes @hnode/tidy@0.20.2 uninstall
76
76
  ```
77
77
 
78
- 제거 후 앱과 로그인 자동 실행 등록이 없어지고 설정은 보관돼야 합니다. macOS 기본 타일링과 시스템 단축키는 변경하지 않습니다. 실패 시 `sw_vers`, `uname -m`, `node --version`과 `npx --yes @hnode/tidy@0.20.0 status` 결과를 기록하세요. 설치 실패 시 터미널에 출력된 오류도 함께 확인합니다.
78
+ 제거 후 앱과 로그인 자동 실행 등록이 없어지고 설정은 보관돼야 합니다. macOS 기본 타일링과 시스템 단축키는 변경하지 않습니다. 실패 시 `sw_vers`, `uname -m`, `node --version`과 `npx --yes @hnode/tidy@0.20.2 status` 결과를 기록하세요. 설치 실패 시 터미널에 출력된 오류도 함께 확인합니다.
79
79
 
80
80
  ## User commands
81
81
 
Binary file
@@ -72,8 +72,12 @@
72
72
  "Fill remaining space · {count} slots": "남은 공간 채우기 · {count}칸",
73
73
  "Could not restore the previous extension. Run uninstall again.": "기존 확장 복원 실패. uninstall을 다시 실행하세요.",
74
74
  "The previous Tidy did not stop. The update was cancelled.": "기존 Tidy가 중지되지 않아 업데이트를 멈췄습니다.",
75
- "The new version is installed. GNOME cannot reload cached JavaScript during the current session.": "새 버전 설치 완료. GNOME은 현재 로그인에서 읽은 JavaScript를 다시 불러올 수 없습니다.",
76
- "Log out and log back in once to activate the new Tidy automatically.": "한 번 로그아웃하고 다시 로그인하면 새 Tidy가 자동으로 활성화됩니다.",
75
+ "[Login required] Log out and log back in to apply the update.": "[재로그인 필요] 업데이트를 적용하려면 로그아웃한 뒤 다시 로그인하세요.",
76
+ "Tidy will start automatically at the next login. Turning the extension off and on does not apply the new code.": "다음 로그인에서 Tidy가 자동으로 활성화됩니다. 확장을 껐다 켜는 것만으로는 새 코드가 적용되지 않습니다.",
77
+ "[Update notice] GNOME extension code updates require logging out and back in.": "[업데이트 안내] GNOME 확장 코드를 업데이트한 뒤에는 로그아웃 후 다시 로그인해야 적용됩니다.",
78
+ "This extension code version is already loaded, so no logout is needed this time.": "이번에는 이미 사용 중인 확장 코드 버전이므로 재로그인 없이 바로 사용할 수 있습니다.",
79
+ "Moved Tidy to {uuid}. Your settings and custom shortcuts have been kept.": "Tidy 확장 식별자를 {uuid}로 변경했습니다. 기존 설정과 사용자 지정 단축키는 유지됩니다.",
80
+ "GNOME could not remove the previous Tidy extension.": "GNOME에서 이전 Tidy 확장을 제거하지 못했습니다.",
77
81
  "The previous Tidy has been stopped for this session.": "현재 세션에서는 이전 Tidy를 중지해 잘못 표시되는 패널을 제거했습니다.",
78
82
  "Install Tidy, then log out and log back in.": "Tidy를 설치한 다음 로그아웃하고 다시 로그인하세요.",
79
83
  "New Tidy code is installed. Please log out and log back in to apply it automatically.": "새 Tidy 코드가 설치됐습니다. 한 번 로그아웃하고 다시 로그인하면 자동 적용됩니다.",
@@ -95,7 +99,7 @@
95
99
  "Remove symlink installations manually: {path}": "심볼릭 링크 설치는 수동으로 제거하세요: {path}",
96
100
  "Unknown error": "알 수 없는 오류",
97
101
  "Press Super to open window overview and layouts together. Drag a window thumbnail onto a layout cell. Layouts are hidden in the Super+A app grid. Default: on.": "Super로 창 보기와 배치 선택기를 함께 엽니다. 창 썸네일을 배치 칸으로 끌어 놓으세요. Super+A 앱 목록에서는 선택기를 숨깁니다. 기본값: 켬",
98
- "Show running app icons inside empty layout regions. Select an icon to tile its window, or click elsewhere or press Esc to finish. Default: off.": "빈 배치 영역 안에 실행 중인 앱 아이콘을 표시합니다. 아이콘을 선택하면 창을 배치하고, 다른 곳을 클릭하거나 Esc를 누르면 마무리합니다. 기본값: 끔",
102
+ "Show live window previews and titles inside empty layout regions, including separate windows of the same app. Select a preview to tile that window, or click elsewhere or press Esc to finish. Default: off.": "빈 배치 영역에 실제 창의 축소 미리보기와 제목을 표시합니다. 같은 앱의 여러 창도 각각 선택할 수 있습니다. 미리보기를 선택하면 해당 창을 배치하고, 다른 곳을 클릭하거나 Esc를 누르면 마무리합니다. 기본값: 끔",
99
103
  "Layout picker size": "배치 선택기 크기",
100
104
  "Overview picker size": "창 보기 선택기 크기",
101
105
  "Percent of the normal picker size. 100% keeps both the same size.": "일반 선택기 크기에 대한 비율입니다. 100%이면 두 화면에서 같은 크기로 표시합니다.",
package/metadata.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "uuid": "winubun@winubun.local",
2
+ "uuid": "tidy@hnode",
3
3
  "name": "Tidy",
4
4
  "description": "Top layout picker, optional snap assist, and customizable window tiling shortcuts",
5
5
  "shell-version": [
@@ -10,6 +10,6 @@
10
10
  "50"
11
11
  ],
12
12
  "settings-schema": "org.gnome.shell.extensions.winubun",
13
- "version": 22,
13
+ "version": 24,
14
14
  "url": "https://github.com/hojin-v/Tidy"
15
15
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hnode/tidy",
3
- "version": "0.20.0",
3
+ "version": "0.20.2",
4
4
  "description": "Window tiling for GNOME and macOS with a layout picker, custom shortcuts and multi-monitor support",
5
5
  "type": "module",
6
6
  "bin": {
@@ -22,7 +22,7 @@
22
22
  "scripts/manage.py",
23
23
  "scripts/i18n.py",
24
24
  "scripts/recover.js",
25
- "dist/winubun@winubun.local.shell-extension.zip",
25
+ "dist/tidy@hnode.shell-extension.zip",
26
26
  "docs/README.en.md",
27
27
  "docs/DEVELOPMENT.md",
28
28
  "docs/MACOS.md",
package/scripts/manage.py CHANGED
@@ -14,7 +14,8 @@ sys.path.insert(0, str(Path(__file__).resolve().parent))
14
14
  from i18n import _
15
15
 
16
16
  ROOT = Path(__file__).resolve().parent.parent
17
- UUID = 'winubun@winubun.local'
17
+ UUID = 'tidy@hnode'
18
+ LEGACY_UUIDS = ('winubun@winubun.local', 'tidy@hnode.dev')
18
19
  DATA = Path(os.environ.get('XDG_DATA_HOME', Path.home() / '.local/share'))
19
20
  STATE = Path(os.environ.get('XDG_STATE_HOME', Path.home() / '.local/state')) / 'winubun'
20
21
  DEST = DATA / 'gnome-shell/extensions' / UUID
@@ -109,6 +110,55 @@ def finish_update():
109
110
  AUTOSTART.unlink(missing_ok=True)
110
111
 
111
112
 
113
+ def print_update_notice(requires_login, stream=None):
114
+ stream = stream or sys.stdout
115
+ print(file=stream)
116
+ if requires_login:
117
+ print(_('[Login required] Log out and log back in to apply the update.'), file=stream)
118
+ print(_('Tidy will start automatically at the next login. Turning the extension off and on does not apply the new code.'), file=stream)
119
+ else:
120
+ print(_('[Update notice] GNOME extension code updates require logging out and back in.'), file=stream)
121
+ print(_('This extension code version is already loaded, so no logout is needed this time.'), file=stream)
122
+
123
+
124
+ def recover_settings(directory):
125
+ schema_dir = directory / 'schemas'
126
+ if schema_dir.exists():
127
+ env = dict(os.environ, GSETTINGS_SCHEMA_DIR=str(schema_dir))
128
+ subprocess.run(['gjs', '-m', str(directory / 'scripts/recover.js')], env=env, check=True)
129
+
130
+
131
+ def migrate_legacy():
132
+ installations = []
133
+ for uuid in LEGACY_UUIDS:
134
+ legacy = DATA / 'gnome-shell/extensions' / uuid
135
+ if legacy.is_symlink():
136
+ raise RuntimeError(_('Manage symlink installations manually: {path}', path=legacy))
137
+ registered = extension_info(uuid)
138
+ if not registered and not legacy.exists():
139
+ continue
140
+ if registered:
141
+ set_enabled(uuid, False)
142
+ wait_for_extension(uuid, False)
143
+ installations.append((uuid, legacy, registered))
144
+ if not installations:
145
+ return False
146
+ # Keep the original schema and state directory so custom shortcuts and the
147
+ # settings recovery journal survive the UUID change. Stop all old copies
148
+ # before recovering shared settings or restoring another tiler.
149
+ for _uuid, legacy, _registered in installations:
150
+ recover_settings(legacy)
151
+ restore_competitors()
152
+ for uuid, legacy, registered in installations:
153
+ if registered and registered.get('type') != 1:
154
+ if not shell_call('UninstallExtension', '(s)', (uuid,))[0]:
155
+ raise RuntimeError(_('GNOME could not remove the previous Tidy extension.'))
156
+ if legacy.exists():
157
+ shutil.rmtree(legacy)
158
+ print(_('Moved Tidy to {uuid}. Your settings and custom shortcuts have been kept.', uuid=UUID))
159
+ return True
160
+
161
+
112
162
  def run(*args, check=True):
113
163
  return subprocess.run(args, check=check, text=True, capture_output=True,
114
164
  env=dict(os.environ, LC_ALL='C'))
@@ -181,6 +231,10 @@ def install(archive=None):
181
231
  raise RuntimeError(_('The bundled extension does not match this installer. Download Tidy again.'))
182
232
  if DEST.is_symlink():
183
233
  raise RuntimeError(_('Manage symlink installations manually: {path}', path=DEST))
234
+ for uuid in LEGACY_UUIDS:
235
+ legacy = DATA / 'gnome-shell/extensions' / uuid
236
+ if legacy.is_symlink():
237
+ raise RuntimeError(_('Manage symlink installations manually: {path}', path=legacy))
184
238
  # The session may need to discover a first installation at the next login.
185
239
  # Keep the original tiler active until Tidy is actually available.
186
240
  registered = extension_info()
@@ -197,14 +251,16 @@ def install(archive=None):
197
251
  package.extractall(DEST)
198
252
  if 'schemas/gschemas.compiled' not in package.namelist():
199
253
  run('glib-compile-schemas', '--strict', str(DEST / 'schemas'))
254
+ migrated = migrate_legacy()
200
255
  install_launcher()
201
256
  if not registered or registered.get('version') != metadata['version']:
202
257
  schedule_update(metadata['version'])
203
- print(_('The new version is installed. GNOME cannot reload cached JavaScript during the current session.'))
204
- print(_('Log out and log back in once to activate the new Tidy automatically.'))
205
- print(_('The previous Tidy has been stopped for this session.'))
258
+ if registered or migrated:
259
+ print(_('The previous Tidy has been stopped for this session.'))
260
+ print_update_notice(True)
206
261
  return
207
262
  activate()
263
+ print_update_notice(False)
208
264
 
209
265
 
210
266
  def activate():
@@ -252,6 +308,16 @@ def apply_update():
252
308
  raise RuntimeError(_('GNOME has not registered Tidy yet. Launch Tidy from the app list.'))
253
309
 
254
310
 
311
+ def status():
312
+ info = extension_info()
313
+ print(json.dumps(info, ensure_ascii=False, indent=2) if info else _('The extension is not registered in the current session.'))
314
+ if (STATE / 'pending-update.json').exists():
315
+ expected = json.loads((DEST / 'metadata.json').read_text())['version']
316
+ if info.get('version') != expected:
317
+ # Keep stdout machine-readable when GNOME returned a JSON status.
318
+ print_update_notice(True, sys.stderr)
319
+
320
+
255
321
  def uninstall():
256
322
  if DEST.is_symlink():
257
323
  raise RuntimeError(_('Remove symlink installations manually: {path}', path=DEST))
@@ -262,10 +328,7 @@ def uninstall():
262
328
  elif DEST.exists():
263
329
  print(_('The extension is not registered in this session. Checking settings recovery.'))
264
330
  # Also recover settings if a Shell crash prevented disable() from running.
265
- schema_dir = DEST / 'schemas'
266
- if schema_dir.exists():
267
- env = dict(os.environ, GSETTINGS_SCHEMA_DIR=str(schema_dir))
268
- subprocess.run(['gjs', '-m', str(DEST / 'scripts/recover.js')], env=env, check=True)
331
+ recover_settings(DEST)
269
332
  restore_competitors()
270
333
  finish_update()
271
334
  if registered:
@@ -293,9 +356,6 @@ def main():
293
356
  open_preferences()
294
357
  elif args.command == 'prefs':
295
358
  open_preferences()
296
- elif args.command == 'status':
297
- info = extension_info()
298
- print(json.dumps(info, ensure_ascii=False, indent=2) if info else _('The extension is not registered in the current session.'))
299
359
  else:
300
360
  globals()[args.command]()
301
361