@eclipse-docks/core 0.7.113 → 0.7.114

package/src/components/release-history.ts

@@ -0,0 +1,177 @@
+import { html, css } from "lit";
+import { customElement, state } from "lit/decorators.js";
+import { unsafeHTML } from "lit/directives/unsafe-html.js";
+import { marked } from "marked";
+import { DocksPart } from "../parts/part";
+import { appLoaderService, type ReleaseEntry } from "../core/apploader";
+import { createLogger } from "../core/logger";
+
+const logger = createLogger("ReleaseHistory");
+
+async function loadReleases(
+    releaseHistory?: ReleaseEntry[] | (() => ReleaseEntry[] | Promise<ReleaseEntry[]>),
+): Promise<ReleaseEntry[]> {
+    if (!releaseHistory) return [];
+    if (typeof releaseHistory !== "function") return releaseHistory;
+
+    try {
+        return await releaseHistory();
+    } catch (error) {
+        logger.error(
+            `Failed to load release history from app: ${error instanceof Error ? error.message : String(error)}`,
+        );
+        return [];
+    }
+}
+
+function semverEqual(a: string, b: string): boolean {
+    return a.replace(/^v/i, "") === b.replace(/^v/i, "");
+}
+
+function isNewerThan(releaseTag: string, currentVersion: string): boolean {
+    const currentParts = currentVersion.replace(/^v/i, "").split(".").map(Number);
+    const releaseParts = releaseTag.replace(/^v/i, "").split(".").map(Number);
+    for (let i = 0; i < Math.max(currentParts.length, releaseParts.length); i++) {
+        const current = currentParts[i] || 0;
+        const releasePart = releaseParts[i] || 0;
+        if (releasePart > current) return true;
+        if (releasePart < current) return false;
+    }
+    return false;
+}
+
+@customElement("docks-release-history")
+export class DocksReleaseHistory extends DocksPart {
+    protected scrollMode: "scroller" | "native" | "none" = "none";
+
+    @state()
+    private appVersion = "0.0.0";
+
+    @state()
+    private releases: ReleaseEntry[] = [];
+
+    @state()
+    private currentReleaseIndex = 0;
+
+    static styles = [
+        css`
+            .release-panel {
+                display: flex;
+                flex-direction: column;
+                gap: 0.5rem;
+                height: 100%;
+                padding: 0.75rem;
+                box-sizing: border-box;
+            }
+
+            .release-panel wa-scroller {
+                flex: 1;
+                min-height: 0;
+            }
+
+            .release-nav {
+                display: flex;
+                gap: 0.5rem;
+            }
+        `,
+    ];
+
+    protected doInitUI() {
+        void this.load();
+    }
+
+    private async load() {
+        const app = appLoaderService.getCurrentApp();
+        this.appVersion = app?.version ?? "0.0.0";
+        this.releases = await loadReleases(app?.releaseHistory);
+        const currentIndex = this.releases.findIndex((release) =>
+            semverEqual(release.tag_name, this.appVersion),
+        );
+        this.currentReleaseIndex = currentIndex >= 0 ? currentIndex : 0;
+    }
+
+    private showOlder() {
+        if (this.currentReleaseIndex < this.releases.length - 1) {
+            this.currentReleaseIndex += 1;
+        }
+    }
+
+    private showNewer() {
+        if (this.currentReleaseIndex > 0) {
+            this.currentReleaseIndex -= 1;
+        }
+    }
+
+    protected renderContent() {
+        const release = this.releases[this.currentReleaseIndex];
+        if (!release) {
+            return html`<div class="release-panel">No release history available.</div>`;
+        }
+
+        const isCurrent = semverEqual(release.tag_name, this.appVersion);
+        const showUpdateHint = !isCurrent && isNewerThan(release.tag_name, this.appVersion);
+        const atOldest = this.currentReleaseIndex === this.releases.length - 1;
+        const atNewest = this.currentReleaseIndex === 0;
+        const bodyHtml = release.body
+            ? (marked.parse(release.body, { async: false }) as string)
+            : "";
+
+        return html`
+            <div class="release-panel">
+                <p>
+                    <strong>Version:</strong> ${release.tag_name}${isCurrent ? " (Current)" : ""}
+                </p>
+                <p>
+                    <strong>Released:</strong>
+                    <wa-format-date
+                        .date=${release.published_at}
+                        month="short"
+                        day="numeric"
+                        year="numeric"
+                    ></wa-format-date>
+                </p>
+                ${showUpdateHint
+                    ? html`
+                        <wa-callout variant="warning">
+                            <wa-icon slot="icon" name="triangle-exclamation"></wa-icon>
+                            Update available — reload the page to update
+                        </wa-callout>
+                    `
+                    : ""}
+                <wa-scroller orientation="vertical">
+                    ${bodyHtml
+                        ? html`<div style="white-space: normal;">${unsafeHTML(bodyHtml)}</div>`
+                        : ""}
+                </wa-scroller>
+                ${this.releases.length > 1
+                    ? html`
+                        <div class="release-nav">
+                            <wa-button-group>
+                                <wa-button
+                                    variant="default"
+                                    ?disabled=${atOldest}
+                                    @click=${() => this.showOlder()}
+                                >
+                                    ← Previous
+                                </wa-button>
+                                <wa-button
+                                    variant="default"
+                                    ?disabled=${atNewest}
+                                    @click=${() => this.showNewer()}
+                                >
+                                    Next →
+                                </wa-button>
+                            </wa-button-group>
+                        </div>
+                    `
+                    : ""}
+            </div>
+        `;
+    }
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "docks-release-history": DocksReleaseHistory;
+    }
+}

package/src/components/tasks.ts

@@ -1,6 +1,6 @@
 import {contributionRegistry} from "../core/contributionregistry";
-import {TOOLBAR_BOTTOM_CENTER} from "../core/constants";
-import {TOOLBAR_TASKS} from "../core/ui-ids";
+import {TOOLBAR_BOTTOM_CENTER} from "../core/contribution-targets";
+import {TOOLBAR_TASKS} from "../core/contribution-names";
 import {customElement} from "lit/decorators.js";
 import { DocksElement } from "../parts/element";
 import {css, html, render} from "lit";

package/src/contributions/default-layout-contributions.ts

@@ -1,6 +1,6 @@
 import "../layouts/standard-layout";
 import { contributionRegistry } from "../core/contributionregistry";
-import { SYSTEM_LAYOUTS } from "../core/constants";
+import { SYSTEM_LAYOUTS } from "../core/contribution-targets";
 
 const standardLayouts: Array<{
     id: string;

package/src/contributions/default-ui-contributions.ts

@@ -1,13 +1,19 @@
 import { html } from "lit";
 import { contributionRegistry, type HTMLContribution } from "../core/contributionregistry";
 import {
+    ABOUT_TABS,
     PANEL_BOTTOM,
     SIDEBAR_MAIN,
     SIDEBAR_MAIN_TOOLBAR,
+    SYSTEM_ATTRIBUTIONS,
     TOOLBAR_BOTTOM_END,
     TOOLBAR_MAIN_RIGHT
-} from "../core/constants";
+} from "../core/contribution-targets";
 import {
+    ABOUT_TAB_ATTRIBUTIONS,
+    ABOUT_TAB_PACKAGES,
+    ABOUT_TAB_RELEASE,
+    ATTRIBUTION_ECLIPSE_DOCKS,
     VIEW_FILEBROWSER,
     VIEW_LOG_TERMINAL,
     TOOLBAR_LAYOUT_SWITCHER,
@@ -15,7 +21,7 @@ import {
     TOOLBAR_INFO,
     TOOLBAR_LANGUAGE_SELECTOR,
     SIDEBAR_TOOLBAR_EXTENSIONS
-} from "../core/ui-ids";
+} from "../core/contribution-names";
 
 contributionRegistry.registerContribution(SIDEBAR_MAIN, {
     name: VIEW_FILEBROWSER,
@@ -31,6 +37,47 @@ contributionRegistry.registerContribution(PANEL_BOTTOM, {
     component: (id: string) => html`<docks-log-terminal id="${id}"></docks-log-terminal>`
 });
 
+contributionRegistry.registerContribution(ABOUT_TABS, {
+    name: ABOUT_TAB_ATTRIBUTIONS,
+    label: "Attributions",
+    icon: "copyright",
+    ranking: 100,
+    toolbar: false,
+    contextMenu: false,
+    component: (id: string) => html`<docks-attribution id="${id}"></docks-attribution>`
+});
+
+contributionRegistry.registerContribution(ABOUT_TABS, {
+    name: ABOUT_TAB_RELEASE,
+    label: "Release History",
+    icon: "clock-rotate-left",
+    ranking: 50,
+    toolbar: false,
+    contextMenu: false,
+    component: (id: string) => html`<docks-release-history id="${id}"></docks-release-history>`
+});
+
+contributionRegistry.registerContribution(ABOUT_TABS, {
+    name: ABOUT_TAB_PACKAGES,
+    label: "NPM Packages",
+    icon: "cubes",
+    ranking: 0,
+    toolbar: false,
+    contextMenu: false,
+    component: (id: string) => html`<docks-npm-packages id="${id}"></docks-npm-packages>`
+});
+
+contributionRegistry.registerContribution(SYSTEM_ATTRIBUTIONS, {
+    name: ATTRIBUTION_ECLIPSE_DOCKS,
+    label: "Eclipse Docks",
+    component: () => html`
+        <p>
+            Eclipse Docks is made available under the
+            <a href="https://www.eclipse.org/legal/epl-2.0" target="_blank" rel="noopener noreferrer">Eclipse Public License 2.0</a>.
+        </p>
+    `
+} as HTMLContribution);
+
 contributionRegistry.registerContribution(TOOLBAR_BOTTOM_END, {
     name: TOOLBAR_INFO,
     label: "Info",

package/src/core/apploader.ts

@@ -17,7 +17,7 @@ import { rootContext } from "./di";
 import { createLogger } from "./logger";
 import { extensionRegistry, Extension } from "./extensionregistry";
 import { contributionRegistry, Contribution, LayoutContribution, TOPIC_CONTRIBUTEIONS_CHANGED } from "./contributionregistry";
-import { SYSTEM_LAYOUTS } from "./constants";
+import { SYSTEM_LAYOUTS } from "./contribution-targets";
 import { appSettings } from "./settingsservice";
 import { marketplaceRegistry } from "./marketplaceregistry";
 import { contributionTargetMappingRegistry, type ContributionNameRemap } from "./contribution-mapping";

package/src/core/constants.ts

@@ -1,33 +1,13 @@
-// Toolbars
-export const TOOLBAR_MAIN = "app-toolbars-main"
-export const TOOLBAR_MAIN_RIGHT = "app-toolbars-main-right"
-export const TOOLBAR_MAIN_CENTER = "app-toolbars-main-center"
-export const TOOLBAR_BOTTOM = "app-toolbars-bottom"
-export const TOOLBAR_BOTTOM_CENTER = "app-toolbars-bottom-center"
-export const TOOLBAR_BOTTOM_END = "app-toolbars-bottom-end"
-
-/** Commands/HTML at the end of the main sidebar activity rail (wa-tab-group nav slot). */
-export const SIDEBAR_MAIN_TOOLBAR = "sidebar-main-toolbar"
-
-export const SYSTEM_VIEWS = "system-views"
-export const SYSTEM_LAYOUTS = "system.layouts"
-
-// VS Code-style layout containers
-export const EDITOR_AREA_MAIN = "editor-area-main"
-export const SIDEBAR_MAIN = "sidebar-main"
-export const SIDEBAR_MAIN_BOTTOM = "sidebar-main-bottom"
-export const SIDEBAR_AUXILIARY = "sidebar-auxiliary"
-export const PANEL_BOTTOM = "panel-bottom"
+export * from './contribution-targets';
 
 export const COMMAND_SAVE = "command-save"
 
 export const HIDE_DOT_RESOURCE = false
 
-// Mouse button constants
 export enum MouseButton {
     LEFT = 0,
     MIDDLE = 1,
     RIGHT = 2,
     BACK = 3,
     FORWARD = 4
-}
+}

package/src/core/contribution-names.ts

@@ -0,0 +1,34 @@
+export const VIEW_FILEBROWSER = "view.filebrowser";
+export const VIEW_LOG_TERMINAL = "view.logTerminal";
+
+export const TOOLBAR_INFO = "toolbar.info";
+export const TOOLBAR_FAST_VIEWS = "toolbar.fastViews";
+export const TOOLBAR_LANGUAGE_SELECTOR = "toolbar.languageSelector";
+/** Main toolbar (right): layout picker (`docks-layout-switcher`). */
+export const TOOLBAR_LAYOUT_SWITCHER = "toolbar.layoutSwitcher";
+/** Main toolbar (right): dark/light theme toggle (`switch_theme`). */
+export const TOOLBAR_THEME_SWITCHER = "toolbar.themeSwitcher";
+/** Main toolbar (right): document fullscreen toggle (`fullscreen`). */
+export const TOOLBAR_FULLSCREEN = "toolbar.fullscreen";
+/** Bottom-center toolbar: focused part title / active part indicator (`docks-part-name`). */
+export const TOOLBAR_ACTIVE_PART_NAME = "toolbar.activePartName";
+/** Bottom-center toolbar: background tasks / progress (`docks-tasks`). */
+export const TOOLBAR_TASKS = "toolbar.tasks";
+
+/** Main sidebar header toolbar: open extensions (`open_extensions` command). */
+export const SIDEBAR_TOOLBAR_EXTENSIONS = "sidebar.toolbar.extensions";
+
+/** Default file-type → icon mappings on `system.icons`. */
+export const SYSTEM_DEFAULT_FILE_ICONS = "system.icons.default";
+
+export const ABOUT_TAB_RELEASE = "about.tab.release";
+export const ABOUT_TAB_PACKAGES = "about.tab.packages";
+export const ABOUT_TAB_ATTRIBUTIONS = "about.tab.attributions";
+
+export const ATTRIBUTION_ECLIPSE_DOCKS = "attribution.eclipse-docks";
+
+export const TOOLBAR_FILEBROWSER_RENAME = "toolbar.filebrowser.rename";
+export const TOOLBAR_FILEBROWSER_DELETE = "toolbar.filebrowser.delete";
+
+export const CTXMENU_FILEBROWSER_RENAME = "contextmenu.filebrowser.rename";
+export const CTXMENU_FILEBROWSER_DELETE = "contextmenu.filebrowser.delete";

package/src/core/contribution-targets.ts

@@ -0,0 +1,24 @@
+export const TOOLBAR_MAIN = "app-toolbars-main"
+export const TOOLBAR_MAIN_RIGHT = "app-toolbars-main-right"
+export const TOOLBAR_MAIN_CENTER = "app-toolbars-main-center"
+export const TOOLBAR_BOTTOM = "app-toolbars-bottom"
+export const TOOLBAR_BOTTOM_CENTER = "app-toolbars-bottom-center"
+export const TOOLBAR_BOTTOM_END = "app-toolbars-bottom-end"
+
+/** Commands/HTML at the end of the main sidebar activity rail (wa-tab-group nav slot). */
+export const SIDEBAR_MAIN_TOOLBAR = "sidebar-main-toolbar"
+
+export const SYSTEM_VIEWS = "system-views"
+export const SYSTEM_LAYOUTS = "system.layouts"
+
+/** HTML attributions collected by `docks-attribution`. */
+export const SYSTEM_ATTRIBUTIONS = "system.attributions"
+
+/** About dialog tabs (`TabContribution` collected by `docks-tabs`). */
+export const ABOUT_TABS = "about.tabs"
+
+export const EDITOR_AREA_MAIN = "editor-area-main"
+export const SIDEBAR_MAIN = "sidebar-main"
+export const SIDEBAR_MAIN_BOTTOM = "sidebar-main-bottom"
+export const SIDEBAR_AUXILIARY = "sidebar-auxiliary"
+export const PANEL_BOTTOM = "panel-bottom"

package/src/core/contributionregistry.ts

@@ -20,6 +20,11 @@ export interface Contribution {
     showLabel?: boolean;
     icon?: string;
     slot?: string;
+    /**
+     * Higher ranking appears first in `getContributions`. Defaults to 0.
+     * Equal ranks keep registration order.
+     */
+    ranking?: number;
     disabled?: (() => boolean) | Signal.Computed<boolean>;
     /** When false, the contribution is not rendered (default: shown). Honored where supported in UI. */
     visible?: (() => boolean) | Signal.Computed<boolean>;
@@ -135,6 +140,7 @@ class ContributionRegistry {
                 }
             }
         }
+        results.sort((a, b) => (b.ranking ?? 0) - (a.ranking ?? 0));
         if (results.length === 0) {
             this.getOrCreateSlot(target);
         }

package/src/core/editorregistry.ts

@@ -1,4 +1,4 @@
-import { EDITOR_AREA_MAIN } from "./constants";
+import { EDITOR_AREA_MAIN } from "./contribution-targets";
 import { subscribe } from "./events";
 import { File, TOPIC_WORKSPACE_CONNECTED } from "./filesys";
 import { DocksTabs } from "../parts/tabs";

package/src/core/ui-ids.ts

@@ -1,29 +1 @@
-export const VIEW_FILEBROWSER = "view.filebrowser";
-export const VIEW_LOG_TERMINAL = "view.logTerminal";
-
-export const TOOLBAR_INFO = "toolbar.info";
-export const TOOLBAR_FAST_VIEWS = "toolbar.fastViews";
-export const TOOLBAR_LANGUAGE_SELECTOR = "toolbar.languageSelector";
-/** Main toolbar (right): layout picker (`docks-layout-switcher`). */
-export const TOOLBAR_LAYOUT_SWITCHER = "toolbar.layoutSwitcher";
-/** Main toolbar (right): dark/light theme toggle (`switch_theme`). */
-export const TOOLBAR_THEME_SWITCHER = "toolbar.themeSwitcher";
-/** Main toolbar (right): document fullscreen toggle (`fullscreen`). */
-export const TOOLBAR_FULLSCREEN = "toolbar.fullscreen";
-/** Bottom-center toolbar: focused part title / active part indicator (`docks-part-name`). */
-export const TOOLBAR_ACTIVE_PART_NAME = "toolbar.activePartName";
-/** Bottom-center toolbar: background tasks / progress (`docks-tasks`). */
-export const TOOLBAR_TASKS = "toolbar.tasks";
-
-/** Main sidebar header toolbar: open extensions (`open_extensions` command). */
-export const SIDEBAR_TOOLBAR_EXTENSIONS = "sidebar.toolbar.extensions";
-
-/** Default file-type → icon mappings on `system.icons`. */
-export const SYSTEM_DEFAULT_FILE_ICONS = "system.icons.default";
-
-export const TOOLBAR_FILEBROWSER_RENAME = "toolbar.filebrowser.rename";
-export const TOOLBAR_FILEBROWSER_DELETE = "toolbar.filebrowser.delete";
-
-export const CTXMENU_FILEBROWSER_RENAME = "contextmenu.filebrowser.rename";
-export const CTXMENU_FILEBROWSER_DELETE = "contextmenu.filebrowser.delete";
-
+export * from './contribution-names';

package/src/dialogs/index.ts

@@ -14,4 +14,5 @@ export {
   filebrowserDialog,
   type FilebrowserDialogMode,
   type FilebrowserDialogState,
-} from './filebrowser-dialog';
+} from './filebrowser-dialog';
+export { versionInfoDialog } from './version-info-dialog';

package/src/dialogs/version-info-dialog.ts

@@ -0,0 +1,82 @@
+import { html, css } from "lit";
+import { customElement } from "lit/decorators.js";
+import type { PropertyValues } from "lit";
+import { DocksDialogContent } from "../parts/dialog-content";
+import { contributionRegistry } from "../core/contributionregistry";
+import {
+    DIALOG_CONTRIBUTION_TARGET,
+    CLOSE_BUTTON,
+    type DialogContribution,
+    type DialogButton,
+    dialogService,
+} from "../core/dialogservice";
+import { ABOUT_TABS } from "../core/contribution-targets";
+import { appLoaderService } from "../core/apploader";
+
+const CLOSE_PRIMARY: DialogButton = { ...CLOSE_BUTTON, variant: "primary" };
+
+@customElement("docks-version-info-dialog-content")
+export class DocksVersionInfoDialogContent extends DocksDialogContent {
+    static styles = [
+        ...DocksDialogContent.styles,
+        css`
+            :host {
+                display: block;
+            }
+
+            .dialog-body {
+                display: flex;
+                flex-direction: column;
+                gap: 0.75rem;
+                min-width: 32rem;
+                height: 600px;
+            }
+
+            .dialog-body docks-tabs {
+                flex: 1;
+                min-height: 0;
+            }
+        `,
+    ];
+
+    protected firstUpdated(changed: PropertyValues) {
+        super.firstUpdated(changed);
+        const dialog = this.closest("wa-dialog");
+        if (dialog) {
+            dialog.style.setProperty("--width", "600px");
+            dialog.setAttribute("light-dismiss", "");
+        }
+    }
+
+    render() {
+        const app = appLoaderService.getCurrentApp();
+
+        return html`
+            <div class="dialog-body">
+                ${app?.description ? html`<small>${app.description}</small>` : ""}
+                <docks-tabs id=${ABOUT_TABS}></docks-tabs>
+            </div>
+        `;
+    }
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "docks-version-info-dialog-content": DocksVersionInfoDialogContent;
+    }
+}
+
+contributionRegistry.registerContribution<DialogContribution>(DIALOG_CONTRIBUTION_TARGET, {
+    id: "version-info",
+    label: "About",
+    buttons: [CLOSE_PRIMARY],
+    component: () => html`<docks-version-info-dialog-content></docks-version-info-dialog-content>`,
+    onButton: async () => true,
+});
+
+export function versionInfoDialog(): Promise<void> {
+    const app = appLoaderService.getCurrentApp();
+    return dialogService.open("version-info", {
+        label: `About ${app?.name ?? ""} - ${app?.version ?? "0.0.0"}`,
+    });
+}

package/src/layouts/standard-layout.ts

@@ -13,7 +13,7 @@ import {
     TOOLBAR_BOTTOM,
     TOOLBAR_BOTTOM_CENTER,
     TOOLBAR_BOTTOM_END
-} from "../core/constants";
+} from "../core/contribution-targets";
 import {DocksContainer} from "../parts/container";
 
 @customElement('docks-standard-layout')

package/src/parts/tabs.ts

@@ -9,7 +9,8 @@ import {createRef, ref} from "lit/directives/ref.js";
 import { icon } from "../core/icon-utils";
 import {subscribe} from "../core/events";
 import { DocksPart } from "./part";
-import {MouseButton, EDITOR_AREA_MAIN} from "../core/constants";
+import { EDITOR_AREA_MAIN } from "../core/contribution-targets";
+import { MouseButton } from "../core/constants";
 import {activePartSignal, activeEditorSignal, partDirtySignal} from "../core/appstate";
 import {watchSignal} from "../core/signals";
 import {confirmDialog} from "../dialogs";