await new Promise((resolve, reject) => {
+ const $parentWindow = $(elItem).closest('.window');
+ const hasParentWindow = $parentWindow.length > 0;
+
+ let $receiver;
+ let parentUuid;
+ if ( hasParentWindow ) {
+ $receiver = $parentWindow;
+ parentUuid = $parentWindow.attr('data-element_uuid');
+ } else {
+ parentUuid = `weblink-icon-picker-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+ $receiver = $('')
+ .addClass('window')
+ .attr('data-element_uuid', parentUuid)
+ .css('display', 'none')
+ .appendTo('body');
+ }
+
+ let settled = false;
+ let filePicked = false;
+
+ const cleanup = () => {
+ $receiver.off('file_opened', onFileOpened);
+ if ( !hasParentWindow ) {
+ $receiver.remove();
+ }
+ };
+
+ const finish = (fn, value) => {
+ if ( settled ) return;
+ settled = true;
+ cleanup();
+ fn(value);
+ };
+
+ async function onFileOpened (e) {
+ // Set synchronously (before the first await) so on_close, which fires
+ // right after selection, does not resolve null and discard the result.
+ filePicked = true;
+ try {
+ const selectedFile = Array.isArray(e.detail) ? e.detail[0] : e.detail;
+
+ if ( !selectedFile?.path ) {
+ finish(resolve, null);
+ return;
+ }
+
+ finish(resolve, await readIconFromFsEntry(selectedFile));
+ } catch (error) {
+ finish(reject, error);
+ }
+ }
+
+ $receiver.on('file_opened', onFileOpened);
+
+ UIWindow({
+ path: `/${window.user.username}/Desktop`,
+ parent_uuid: parentUuid,
+ parent_center: hasParentWindow,
+ center: !hasParentWindow,
+ allowed_file_types: 'image/*',
+ show_maximize_button: false,
+ show_minimize_button: false,
+ title: i18n('window_title_open'),
+ is_dir: true,
+ is_openFileDialog: true,
+ selectable_body: false,
+ backdrop: true,
+ close_on_backdrop_click: true,
+ stay_on_top: true,
+ // Fires on any dismissal (cancel button, X, backdrop, Escape).
+ on_close: () => {
+ if ( !filePicked ) finish(resolve, null);
+ },
+ }).catch((error) => finish(reject, error));
+});
+
+export const updateWeblinkIcon = async ({ path, icon }) => {
+ const data = await readWeblinkData(path);
+ data.icon = icon;
+ data.modified = Date.now();
+ data.version = WEBLINK_VERSION;
+
+ await puter.fs.write(path, JSON.stringify(data), { overwrite: true });
+ return data;
+};
+
+export const changeWeblinkIcon = async (elItem) => {
+ const $item = $(elItem);
+ const icon = await chooseWeblinkIcon(elItem);
+
+ if ( !icon ) {
+ return null;
+ }
+
+ const path = $item.attr('data-path');
+ await updateWeblinkIcon({ path, icon });
+
+ // Update every live view of this item (Desktop + any open folder windows),
+ // not just the clicked one, so the icon doesn't look stale elsewhere.
+ const uid = $item.attr('data-uid');
+ const $views = uid ? $(`.item[data-uid="${uid}"]`) : $item;
+ $views.find('.item-icon > img').attr('src', icon);
+ $views.attr('data-icon', icon);
+
+ weblinkIconCache.set(path, icon);
+
+ return icon;
+};
+
+export const getWeblinkIcon = async (fsentry) => {
+ const path = fsentry.path;
+
+ if ( !path ) {
+ // Avoid a doomed puter.fs.read({ path: undefined }) for listing entries
+ // that don't carry a path.
+ return defaultWeblinkIcon();
+ }
+
+ if ( weblinkIconCache.has(path) ) {
+ return weblinkIconCache.get(path);
+ }
+
+ try {
+ const data = await readWeblinkData(path);
+ const icon = data.icon ?? data.metadata?.icon;
+
+ if ( isValidWeblinkIcon(icon) ) {
+ weblinkIconCache.set(path, icon);
+ return icon;
+ }
+ } catch (e) {
+ // Older weblinks may contain only a URL or malformed legacy JSON.
+ }
+
+ return defaultWeblinkIcon();
+};
+
+// Shared "Change Icon" context-menu entry so UIItem and generate_file_context_menu
+// stay in sync instead of duplicating the block.
+export const weblinkChangeIconMenuItem = (elItem) => ({
+ html: i18n('change_icon'),
+ onClick: async function () {
+ try {
+ await changeWeblinkIcon(elItem);
+ } catch (error) {
+ UIAlert(error.message ?? 'Could not change the web link icon.');
+ }
+ },
+});
diff --git a/src/gui/src/i18n/translations/en.js b/src/gui/src/i18n/translations/en.js
index 55155441f..98e22d8d8 100644
--- a/src/gui/src/i18n/translations/en.js
+++ b/src/gui/src/i18n/translations/en.js
@@ -96,6 +96,7 @@ const en = {
cpu: 'CPU',
create_account: 'Create Account',
create_free_account: 'Create Free Account',
+ change_icon: 'Change Icon',
create_desktop_shortcut: 'Create Shortcut (Desktop)',
create_desktop_shortcut_s: 'Create Shortcuts (Desktop)',
create_shortcut: 'Create Shortcut',