28788771886

Committed 06 Jul 2026 11:38AM UTC coverage: 28.51% (+0.008%) from 28.502%

Build # 28788771886

Build Type

Pull #535

github

Committed by

web-flow

Commit Message

Merge d9131b781 into 571599d46

Pull Request Pull Request #535: feat: persistent navigation context with back-link and post-publish forwarding

Coverage Stats

1811 of 7177 branches covered (25.23%)

Branch coverage included in aggregate %.

3710 of 12188 relevant lines covered (30.44%)

4.52 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

71.21

src/main/java/com/knowledgepixels/nanodash/component/TitleBar.java

package com.knowledgepixels.nanodash.component;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;

import org.apache.wicket.behavior.AttributeAppender;
import org.apache.wicket.markup.html.WebMarkupContainer;
import org.apache.wicket.markup.html.WebPage;
import org.apache.wicket.markup.html.link.BookmarkablePageLink;
import org.apache.wicket.markup.html.panel.EmptyPanel;
import org.apache.wicket.markup.html.panel.Panel;
import org.apache.wicket.markup.repeater.Item;
import org.apache.wicket.markup.repeater.data.DataView;
import org.apache.wicket.markup.repeater.data.ListDataProvider;

import org.apache.wicket.request.mapper.parameter.PageParameters;

import com.knowledgepixels.nanodash.NanodashPageRef;
import com.knowledgepixels.nanodash.NanodashPreferences;
import com.knowledgepixels.nanodash.NavigationContext;
import com.knowledgepixels.nanodash.Utils;
import com.knowledgepixels.nanodash.page.ExplorePage;
import com.knowledgepixels.nanodash.page.HomePage;
import com.knowledgepixels.nanodash.page.NanodashPage;
import com.knowledgepixels.nanodash.page.PublishPage;
import com.knowledgepixels.nanodash.page.QueryListPage;
import com.knowledgepixels.nanodash.page.SpaceListPage;
import com.knowledgepixels.nanodash.page.UserListPage;

/**
 * TitleBar is the top bar of the Nanodash application, which contains
 * navigation elements such as profile, my channel, users, connectors,
 * publish, query, and breadcrumb navigation.
 */
public class TitleBar extends Panel {

    private String highlight;

    /**
     * The breadcrumb/tab strip row (the grey band just below the nav bar). Holds
     * the breadcrumb links on the left and, optionally, the resource tab strip on
     * the right (see {@link #setTabs(ResourceTabs)}).
     */
    private WebMarkupContainer breadcrumbPath;

    /**
     * Constructs a TitleBar with the specified id, page, highlight element,
     * and an array of path references for breadcrumb navigation.
     *
     * @param id        the component id
     * @param page      the current Nanodash page
     * @param highlight the id of the element to highlight
     * @param pathRefs  an array of NanodashPageRef for breadcrumb navigation
     */
    public TitleBar(String id, NanodashPage page, String highlight, NanodashPageRef... pathRefs) {
        super(id);
        this.highlight = highlight;
        add(new ProfileItem("profile", page));
        // Centered title-bar message: the post-publish confirmation and/or the
        // always-on "you haven't published an introduction yet" warning.
        add(new JustPublishedMessagePanel("justPublishedMessage", page.getPageParameters()));

        // Nav links carry the page's navigation context along, so e.g. publishing via
        // the "publish" link forwards back to the space/user/resource one came from.
        PageParameters navParams = NavigationContext.withContext(new PageParameters(), page.getContextId());
        createNavLink("users", UserListPage.class, navParams);
        createNavLink("connectors", SpaceListPage.class, navParams);
        createNavLink("publish", PublishPage.class, navParams).setVisible(!NanodashPreferences.get().isReadOnlyMode());
        createNavLink("query", QueryListPage.class, navParams);

        breadcrumbPath = new WebMarkupContainer("breadcrumbpath");
        if (page.hasFullWidthContent()) {
            // Full-width pages (e.g. query pages): the strip's row follows the
            // content to the left edge instead of centering at the standard width.
            breadcrumbPath.add(new AttributeAppender("class", " fullwidth"));
        }
        WebMarkupContainer breadcrumbLinks = new WebMarkupContainer("breadcrumblinks");
        List<CrumbPart> crumbParts = buildCrumbParts(pathRefs);
        if (!crumbParts.isEmpty()) {
            CrumbPart first = crumbParts.get(0);
            breadcrumbLinks.add(first.ref().createComponent("firstpathelement", first.label()));
            // Getting serialization exception if not using 'new ArrayList<...>(...)' here:
            List<CrumbPart> moreParts = new ArrayList<CrumbPart>(crumbParts.subList(1, crumbParts.size()));
            breadcrumbLinks.add(new DataView<CrumbPart>("morepathelements", new ListDataProvider<CrumbPart>(moreParts)) {

                @Override
                protected void populateItem(Item<CrumbPart> item) {
                    CrumbPart part = item.getModelObject();
                    item.add(part.ref().createComponent("furtherpathelement", part.label()));
                }

            });
        } else {
            breadcrumbLinks.setVisible(false);
        }
        breadcrumbPath.add(breadcrumbLinks);
        // Back-to-context link: on pages without a breadcrumb of their own that are not
        // a context resource's page, show "< XXX" pointing to the navigation context
        // (or "< Home" if none), so the user can always get back to it.
        WebMarkupContainer backContextContainer = new WebMarkupContainer("backcontext-container");
        boolean backCrumbVisible = false;
        if (crumbParts.isEmpty() && !page.isContextPage()) {
            NanodashPageRef backRef = createBackContextRef(page);
            if (backRef != null) {
                backContextContainer.add(backRef.createComponent("backcontext", Utils.truncateLinkLabel(backRef.getLabel())));
                backCrumbVisible = true;
            }
        }
        backContextContainer.setVisible(backCrumbVisible);
        breadcrumbPath.add(backContextContainer);
        // Tab strip placeholder (right side of the strip); replaced via setTabs().
        breadcrumbPath.add(new EmptyPanel("tabs").setVisible(false));
        // The strip shows when there is a breadcrumb to display; setTabs() also
        // forces it visible so a tab strip shows even without a breadcrumb.
        breadcrumbPath.setVisible(pathRefs.length > 0 || backCrumbVisible);
        add(breadcrumbPath);
    }

    /**
     * The target of the back-to-context link for the given page: the navigation context
     * resource, the home page if no context is set, or an explore-page link if the
     * context id cannot (yet) be resolved. Null when the link would point to the page
     * itself.
     */
    private static NanodashPageRef createBackContextRef(NanodashPage page) {
        String contextId = page.getContextId();
        if (contextId == null) {
            if (page instanceof HomePage) return null;
            return new NanodashPageRef(HomePage.class, "Home");
        }
        NanodashPageRef ref = NavigationContext.getPageRef(contextId);
        if (ref == null) {
            // Stale or not-yet-loaded context id: link via the explore page, which
            // forwards known resources to their own pages once the caches are warm.
            ref = new NanodashPageRef(ExplorePage.class, new PageParameters().set("id", contextId), Utils.getShortNameFromURI(contextId));
        }
        if (ref.getPageClass().equals(page.getClass()) && contextId.equals(page.getPageParameters().get("id").toString(""))) {
            return null;
        }
        return ref;
    }

    /**
     * One breadcrumb segment: the {@link NanodashPageRef} it links to and the
     * (possibly split) label text to show for it.
     */
    public record CrumbPart(NanodashPageRef ref, String label) implements Serializable {
    }

    /**
     * Flattens a breadcrumb path into the segments to render. Three transforms are
     * applied to each ref's label:
     * <ul>
     *   <li>For each non-root crumb, the part it shares with its parent label
     *       is stripped (e.g. parent "Knowledge Pixels", child "Knowledge
     *       Pixels Incubator" renders as "Incubator"). The shared part is the
     *       longest common character prefix, but only stripped when it covers
     *       (almost) all of the parent and ends on a non-letter/digit boundary
     *       in the child — this also catches singular/plural variations like
     *       parent "Nano Sessions", child "Nano Session #30" → "#30".</li>
     *   <li>For each non-root crumb, a word-level overlap where the child's
     *       leading word(s) restate the parent's trailing word(s) is stripped
     *       (e.g. parent "Abc Def Ghi", child "Ghi Jkl" renders as "Jkl"). The
     *       longest such parent-suffix/child-prefix overlap wins, matched on
     *       whole words case-insensitively, and never strips the whole child
     *       away.</li>
     *   <li>Only the leading segment of the remaining label is kept — the part
     *       before the first list/title separator ({@code ,}, {@code :},
     *       {@code ;}, {@code |}, or a spaced {@code -}) — so each path level
     *       renders as one concise crumb. E.g. "FIP.38.T.8 | FAIR Implementation
     *       Profile Training Session 8" renders as "FIP.38.T.8" and "3PFF: the
     *       Three Point FAIRification Framework" as "3PFF".</li>
     * </ul>
     * The parent-prefix comparison uses the original (un-simplified) labels.
     */
    static List<CrumbPart> buildCrumbParts(NanodashPageRef[] pathRefs) {
        List<CrumbPart> parts = new ArrayList<>();
        for (int i = 0; i < pathRefs.length; i++) {
            String label = pathRefs[i].getLabel();
            if (label == null) {
                parts.add(new CrumbPart(pathRefs[i], null));
                continue;
            }
            if (i > 0) {
                String parentLabel = pathRefs[i - 1].getLabel();
                label = stripParentPrefix(parentLabel, label);
                label = stripParentOverlap(parentLabel, label);
            }
            // Show only the leading segment (before the first list/title separator)
            // so each path level renders as one concise crumb — e.g.
            // "FIP.38.T.8 | FAIR Implementation Profile Training Session 8" → "FIP.38.T.8",
            // "3PFF: the Three Point FAIRification Framework" → "3PFF".
            List<String> segments = splitLabel(label);
            if (!segments.isEmpty()) {
                parts.add(new CrumbPart(pathRefs[i], truncateLabel(segments.get(0))));
            }
        }
        return parts;
    }

    /**
     * Truncates an over-long crumb label so a single crumb never blows up the
     * breadcrumb strip. Delegates to {@link Utils#truncateLinkLabel(String)} so
     * breadcrumbs and entity links share one truncation rule.
     */
    static String truncateLabel(String label) {
        return Utils.truncateLinkLabel(label);
    }

    /**
     * Splits a label on list/title separators — comma, colon, semicolon, pipe
     * (with or without surrounding spaces), or a space-surrounded hyphen — into
     * trimmed, non-empty segments. Returns the trimmed whole label if there is
     * no separator (so the result always has at least one element).
     */
    static List<String> splitLabel(String label) {
        List<String> segments = new ArrayList<>();
        if (label == null) return segments;
        for (String s : label.split("\\s*[,;:]\\s+|\\s*\\|\\s*|\\s+-\\s+")) {
            String trimmed = s.trim();
            if (!trimmed.isEmpty()) segments.add(trimmed);
        }
        if (segments.isEmpty()) {
            String trimmed = label.trim();
            if (!trimmed.isEmpty()) segments.add(trimmed);
        }
        return segments;
    }

    /**
     * If the child label appears to restate the parent's "topic" at the start,
     * strips that shared prefix and returns the remainder. Otherwise returns
     * the child label unchanged.
     */
    private static String stripParentPrefix(String parent, String child) {
        if (parent == null || parent.isEmpty() || child == null) return child;
        int lcp = 0;
        int max = Math.min(parent.length(), child.length());
        while (lcp < max && parent.charAt(lcp) == child.charAt(lcp)) lcp++;
        // Require a substantial match: at least 3 chars, and within 2 chars of
        // the full parent length (so things like "Sessions" vs "Session" still
        // match, but "Nanopublication Sessions" vs "Nano Session #30" doesn't).
        if (lcp < 3 || lcp < parent.length() - 2) return child;
        // The boundary in the child must not fall mid-word, otherwise we'd be
        // chopping off a partial word like "Foo Bar" -> "Foo Baz Quux" -> "z Quux".
        if (lcp >= child.length() || Character.isLetterOrDigit(child.charAt(lcp))) return child;
        String remainder = child.substring(lcp).replaceAll("^\\s+", "");
        if (remainder.isEmpty()) return child;
        return remainder;
    }

    /**
     * If the child label's leading word(s) restate the parent label's trailing
     * word(s), strips that overlap and returns the remainder. E.g. parent
     * "Abc Def Ghi", child "Ghi Jkl" → "Jkl", or parent "Knowledge Pixels
     * Incubator Office Hours", child "Office Hour 24 June 2026" → "24 June 2026".
     * The overlap is matched on whole words, case-insensitively and tolerating
     * singular/plural variation ("Hours" ≈ "Hour"); the longest parent-suffix that
     * matches a child-prefix wins. Returns the child unchanged when there is no
     * overlap, or when the overlap would consume the whole child label (at least
     * one word is always kept).
     */
    static String stripParentOverlap(String parent, String child) {
        if (parent == null || parent.isEmpty() || child == null || child.isEmpty()) return child;
        String[] parentWords = parent.trim().split("\\s+");
        String[] childWords = child.trim().split("\\s+");
        // Keep at least one child word, so the overlap can cover at most all but
        // the last child word.
        int maxK = Math.min(parentWords.length, childWords.length - 1);
        for (int k = maxK; k >= 1; k--) {
            boolean match = true;
            for (int j = 0; j < k; j++) {
                if (!wordsEquivalent(parentWords[parentWords.length - k + j], childWords[j])) {
                    match = false;
                    break;
                }
            }
            if (match) {
                return String.join(" ", java.util.Arrays.asList(childWords).subList(k, childWords.length));
            }
        }
        return child;
    }

    /**
     * Whether two breadcrumb words count as the same topic word: equal ignoring
     * case, or equal once a single trailing plural "s" is dropped from each (so
     * "Hours" matches "Hour", "Sessions" matches "Session").
     */
    private static boolean wordsEquivalent(String a, String b) {
        if (a.equalsIgnoreCase(b)) return true;
        return depluralize(a).equalsIgnoreCase(depluralize(b));
    }

    private static String depluralize(String word) {
        return word.length() > 1 && (word.endsWith("s") || word.endsWith("S"))
                ? word.substring(0, word.length() - 1)
                : word;
    }

    /**
     * Places a resource tab strip (Content | About | Raw) on the right side of
     * the breadcrumb strip, and forces the strip visible so the tabs show even on
     * pages without a breadcrumb (e.g. user pages). Returns {@code this} for
     * fluent use at the {@code add(...)} call site.
     *
     * @param tabs the tab strip (its markup id must be {@code "tabs"})
     * @return this TitleBar
     */
    public TitleBar setTabs(ResourceTabs tabs) {
        breadcrumbPath.addOrReplace(tabs);
        breadcrumbPath.setVisible(true);
        return this;
    }

    private BookmarkablePageLink<Void> createNavLink(String id, Class<? extends WebPage> pageClass, PageParameters params) {
        BookmarkablePageLink<Void> link = new BookmarkablePageLink<>(id, pageClass, params);
        if (id.equals(highlight)) {
            link.add(new AttributeAppender("class", "selected"));
        }
        add(link);
        return link;
    }

}

1	package com.knowledgepixels.nanodash.component;
2
3	import java.io.Serializable;
4	import java.util.ArrayList;
5	import java.util.List;
6
7	import org.apache.wicket.behavior.AttributeAppender;
8	import org.apache.wicket.markup.html.WebMarkupContainer;
9	import org.apache.wicket.markup.html.WebPage;
10	import org.apache.wicket.markup.html.link.BookmarkablePageLink;
11	import org.apache.wicket.markup.html.panel.EmptyPanel;
12	import org.apache.wicket.markup.html.panel.Panel;
13	import org.apache.wicket.markup.repeater.Item;
14	import org.apache.wicket.markup.repeater.data.DataView;
15	import org.apache.wicket.markup.repeater.data.ListDataProvider;
16
17	import org.apache.wicket.request.mapper.parameter.PageParameters;
18
19	import com.knowledgepixels.nanodash.NanodashPageRef;
20	import com.knowledgepixels.nanodash.NanodashPreferences;
21	import com.knowledgepixels.nanodash.NavigationContext;
22	import com.knowledgepixels.nanodash.Utils;
23	import com.knowledgepixels.nanodash.page.ExplorePage;
24	import com.knowledgepixels.nanodash.page.HomePage;
25	import com.knowledgepixels.nanodash.page.NanodashPage;
26	import com.knowledgepixels.nanodash.page.PublishPage;
27	import com.knowledgepixels.nanodash.page.QueryListPage;
28	import com.knowledgepixels.nanodash.page.SpaceListPage;
29	import com.knowledgepixels.nanodash.page.UserListPage;
30
31	/**
32	* TitleBar is the top bar of the Nanodash application, which contains
33	* navigation elements such as profile, my channel, users, connectors,
34	* publish, query, and breadcrumb navigation.
35	*/
36	public class TitleBar extends Panel {
37
38	private String highlight;
39
40	/**
41	* The breadcrumb/tab strip row (the grey band just below the nav bar). Holds
42	* the breadcrumb links on the left and, optionally, the resource tab strip on
43	* the right (see {@link #setTabs(ResourceTabs)}).
44	*/
45	private WebMarkupContainer breadcrumbPath;
46
47	/**
48	* Constructs a TitleBar with the specified id, page, highlight element,
49	* and an array of path references for breadcrumb navigation.
50	*
51	* @param id the component id
52	* @param page the current Nanodash page
53	* @param highlight the id of the element to highlight
54	* @param pathRefs an array of NanodashPageRef for breadcrumb navigation
55	*/
56	public TitleBar(String id, NanodashPage page, String highlight, NanodashPageRef... pathRefs) {
57	super(id);	9✔
58	this.highlight = highlight;	9✔
59	add(new ProfileItem("profile", page));	39✔
60	// Centered title-bar message: the post-publish confirmation and/or the
61	// always-on "you haven't published an introduction yet" warning.
62	add(new JustPublishedMessagePanel("justPublishedMessage", page.getPageParameters()));	42✔
63
64	// Nav links carry the page's navigation context along, so e.g. publishing via
65	// the "publish" link forwards back to the space/user/resource one came from.
66	PageParameters navParams = NavigationContext.withContext(new PageParameters(), page.getContextId());	21✔
67	createNavLink("users", UserListPage.class, navParams);	18✔
68	createNavLink("connectors", SpaceListPage.class, navParams);	18✔
69	createNavLink("publish", PublishPage.class, navParams).setVisible(!NanodashPreferences.get().isReadOnlyMode());	36!
70	createNavLink("query", QueryListPage.class, navParams);	18✔
71
72	breadcrumbPath = new WebMarkupContainer("breadcrumbpath");	18✔
73	if (page.hasFullWidthContent()) {	9!
74	// Full-width pages (e.g. query pages): the strip's row follows the
75	// content to the left edge instead of centering at the standard width.
76	breadcrumbPath.add(new AttributeAppender("class", " fullwidth"));	×
77	}
78	WebMarkupContainer breadcrumbLinks = new WebMarkupContainer("breadcrumblinks");	15✔
79	List<CrumbPart> crumbParts = buildCrumbParts(pathRefs);	9✔
80	if (!crumbParts.isEmpty()) {	9!
81	CrumbPart first = crumbParts.get(0);	×
82	breadcrumbLinks.add(first.ref().createComponent("firstpathelement", first.label()));	×
83	// Getting serialization exception if not using 'new ArrayList<...>(...)' here:
84	List<CrumbPart> moreParts = new ArrayList<CrumbPart>(crumbParts.subList(1, crumbParts.size()));	×
85	breadcrumbLinks.add(new DataView<CrumbPart>("morepathelements", new ListDataProvider<CrumbPart>(moreParts)) {	×
86
87	@Override
88	protected void populateItem(Item<CrumbPart> item) {
89	CrumbPart part = item.getModelObject();	×
90	item.add(part.ref().createComponent("furtherpathelement", part.label()));	×
91	}	×
92
93	});
94	} else {	×
95	breadcrumbLinks.setVisible(false);	12✔
96	}
97	breadcrumbPath.add(breadcrumbLinks);	30✔
98	// Back-to-context link: on pages without a breadcrumb of their own that are not
99	// a context resource's page, show "< XXX" pointing to the navigation context
100	// (or "< Home" if none), so the user can always get back to it.
101	WebMarkupContainer backContextContainer = new WebMarkupContainer("backcontext-container");	15✔
102	boolean backCrumbVisible = false;	6✔
103	if (crumbParts.isEmpty() && !page.isContextPage()) {	18!
104	NanodashPageRef backRef = createBackContextRef(page);	9✔
105	if (backRef != null) {	6!
106	backContextContainer.add(backRef.createComponent("backcontext", Utils.truncateLinkLabel(backRef.getLabel())));	42✔
107	backCrumbVisible = true;	6✔
108	}
109	}
110	backContextContainer.setVisible(backCrumbVisible);	12✔
111	breadcrumbPath.add(backContextContainer);	30✔
112	// Tab strip placeholder (right side of the strip); replaced via setTabs().
113	breadcrumbPath.add(new EmptyPanel("tabs").setVisible(false));	45✔
114	// The strip shows when there is a breadcrumb to display; setTabs() also
115	// forces it visible so a tab strip shows even without a breadcrumb.
116	breadcrumbPath.setVisible(pathRefs.length > 0 \|\| backCrumbVisible);	33!
117	add(breadcrumbPath);	30✔
118	}	3✔
119
120	/**
121	* The target of the back-to-context link for the given page: the navigation context
122	* resource, the home page if no context is set, or an explore-page link if the
123	* context id cannot (yet) be resolved. Null when the link would point to the page
124	* itself.
125	*/
126	private static NanodashPageRef createBackContextRef(NanodashPage page) {
127	String contextId = page.getContextId();	9✔
128	if (contextId == null) {	6!
129	if (page instanceof HomePage) return null;	9!
130	return new NanodashPageRef(HomePage.class, "Home");	18✔
131	}
132	NanodashPageRef ref = NavigationContext.getPageRef(contextId);	×
133	if (ref == null) {	×
134	// Stale or not-yet-loaded context id: link via the explore page, which
135	// forwards known resources to their own pages once the caches are warm.
136	ref = new NanodashPageRef(ExplorePage.class, new PageParameters().set("id", contextId), Utils.getShortNameFromURI(contextId));	×
137	}
138	if (ref.getPageClass().equals(page.getClass()) && contextId.equals(page.getPageParameters().get("id").toString(""))) {	×
139	return null;	×
140	}
141	return ref;	×
142	}
143
144	/**
145	* One breadcrumb segment: the {@link NanodashPageRef} it links to and the
146	* (possibly split) label text to show for it.
147	*/
148	public record CrumbPart(NanodashPageRef ref, String label) implements Serializable {	27✔
149	}
150
151	/**
152	* Flattens a breadcrumb path into the segments to render. Three transforms are
153	* applied to each ref's label:
154	* <ul>
155	* <li>For each non-root crumb, the part it shares with its parent label
156	* is stripped (e.g. parent "Knowledge Pixels", child "Knowledge
157	* Pixels Incubator" renders as "Incubator"). The shared part is the
158	* longest common character prefix, but only stripped when it covers
159	* (almost) all of the parent and ends on a non-letter/digit boundary
160	* in the child — this also catches singular/plural variations like
161	* parent "Nano Sessions", child "Nano Session #30" → "#30".</li>
162	* <li>For each non-root crumb, a word-level overlap where the child's
163	* leading word(s) restate the parent's trailing word(s) is stripped
164	* (e.g. parent "Abc Def Ghi", child "Ghi Jkl" renders as "Jkl"). The
165	* longest such parent-suffix/child-prefix overlap wins, matched on
166	* whole words case-insensitively, and never strips the whole child
167	* away.</li>
168	* <li>Only the leading segment of the remaining label is kept — the part
169	* before the first list/title separator ({@code ,}, {@code :},
170	* {@code ;}, {@code \|}, or a spaced {@code -}) — so each path level
171	* renders as one concise crumb. E.g. "FIP.38.T.8 \| FAIR Implementation
172	* Profile Training Session 8" renders as "FIP.38.T.8" and "3PFF: the
173	* Three Point FAIRification Framework" as "3PFF".</li>
174	* </ul>
175	* The parent-prefix comparison uses the original (un-simplified) labels.
176	*/
177	static List<CrumbPart> buildCrumbParts(NanodashPageRef[] pathRefs) {
178	List<CrumbPart> parts = new ArrayList<>();	12✔
179	for (int i = 0; i < pathRefs.length; i++) {	24✔
180	String label = pathRefs[i].getLabel();	15✔
181	if (label == null) {	6!
182	parts.add(new CrumbPart(pathRefs[i], null));	×
183	continue;	×
184	}
185	if (i > 0) {	6✔
186	String parentLabel = pathRefs[i - 1].getLabel();	21✔
187	label = stripParentPrefix(parentLabel, label);	12✔
188	label = stripParentOverlap(parentLabel, label);	12✔
189	}
190	// Show only the leading segment (before the first list/title separator)
191	// so each path level renders as one concise crumb — e.g.
192	// "FIP.38.T.8 \| FAIR Implementation Profile Training Session 8" → "FIP.38.T.8",
193	// "3PFF: the Three Point FAIRification Framework" → "3PFF".
194	List<String> segments = splitLabel(label);	9✔
195	if (!segments.isEmpty()) {	9!
196	parts.add(new CrumbPart(pathRefs[i], truncateLabel(segments.get(0))));	42✔
197	}
198	}
199	return parts;	6✔
200	}
201
202	/**
203	* Truncates an over-long crumb label so a single crumb never blows up the
204	* breadcrumb strip. Delegates to {@link Utils#truncateLinkLabel(String)} so
205	* breadcrumbs and entity links share one truncation rule.
206	*/
207	static String truncateLabel(String label) {
208	return Utils.truncateLinkLabel(label);	9✔
209	}
210
211	/**
212	* Splits a label on list/title separators — comma, colon, semicolon, pipe
213	* (with or without surrounding spaces), or a space-surrounded hyphen — into
214	* trimmed, non-empty segments. Returns the trimmed whole label if there is
215	* no separator (so the result always has at least one element).
216	*/
217	static List<String> splitLabel(String label) {
218	List<String> segments = new ArrayList<>();	12✔
219	if (label == null) return segments;	6!
220	for (String s : label.split("\\s[,;:]\\s+\|\\s\\\|\\s*\|\\s+-\\s+")) {	54✔
221	String trimmed = s.trim();	9✔
222	if (!trimmed.isEmpty()) segments.add(trimmed);	21!
223	}
224	if (segments.isEmpty()) {	9!
225	String trimmed = label.trim();	×
226	if (!trimmed.isEmpty()) segments.add(trimmed);	×
227	}
228	return segments;	6✔
229	}
230
231	/**
232	* If the child label appears to restate the parent's "topic" at the start,
233	* strips that shared prefix and returns the remainder. Otherwise returns
234	* the child label unchanged.
235	*/
236	private static String stripParentPrefix(String parent, String child) {
237	if (parent == null \|\| parent.isEmpty() \|\| child == null) return child;	21!
238	int lcp = 0;	6✔
239	int max = Math.min(parent.length(), child.length());	18✔
240	while (lcp < max && parent.charAt(lcp) == child.charAt(lcp)) lcp++;	36✔
241	// Require a substantial match: at least 3 chars, and within 2 chars of
242	// the full parent length (so things like "Sessions" vs "Session" still
243	// match, but "Nanopublication Sessions" vs "Nano Session #30" doesn't).
244	if (lcp < 3 \|\| lcp < parent.length() - 2) return child;	33!
245	// The boundary in the child must not fall mid-word, otherwise we'd be
246	// chopping off a partial word like "Foo Bar" -> "Foo Baz Quux" -> "z Quux".
247	if (lcp >= child.length() \|\| Character.isLetterOrDigit(child.charAt(lcp))) return child;	27!
248	String remainder = child.substring(lcp).replaceAll("^\\s+", "");	21✔
249	if (remainder.isEmpty()) return child;	9!
250	return remainder;	6✔
251	}
252
253	/**
254	* If the child label's leading word(s) restate the parent label's trailing
255	* word(s), strips that overlap and returns the remainder. E.g. parent
256	* "Abc Def Ghi", child "Ghi Jkl" → "Jkl", or parent "Knowledge Pixels
257	* Incubator Office Hours", child "Office Hour 24 June 2026" → "24 June 2026".
258	* The overlap is matched on whole words, case-insensitively and tolerating
259	* singular/plural variation ("Hours" ≈ "Hour"); the longest parent-suffix that
260	* matches a child-prefix wins. Returns the child unchanged when there is no
261	* overlap, or when the overlap would consume the whole child label (at least
262	* one word is always kept).
263	*/
264	static String stripParentOverlap(String parent, String child) {
265	if (parent == null \|\| parent.isEmpty() \|\| child == null \|\| child.isEmpty()) return child;	36!
266	String[] parentWords = parent.trim().split("\\s+");	15✔
267	String[] childWords = child.trim().split("\\s+");	15✔
268	// Keep at least one child word, so the overlap can cover at most all but
269	// the last child word.
270	int maxK = Math.min(parentWords.length, childWords.length - 1);	24✔
271	for (int k = maxK; k >= 1; k--) {	21✔
272	boolean match = true;	6✔
273	for (int j = 0; j < k; j++) {	21✔
274	if (!wordsEquivalent(parentWords[parentWords.length - k + j], childWords[j])) {	39✔
275	match = false;	6✔
276	break;	3✔
277	}
278	}
279	if (match) {	6✔
280	return String.join(" ", java.util.Arrays.asList(childWords).subList(k, childWords.length));	27✔
281	}
282	}
283	return child;	6✔
284	}
285
286	/**
287	* Whether two breadcrumb words count as the same topic word: equal ignoring
288	* case, or equal once a single trailing plural "s" is dropped from each (so
289	* "Hours" matches "Hour", "Sessions" matches "Session").
290	*/
291	private static boolean wordsEquivalent(String a, String b) {
292	if (a.equalsIgnoreCase(b)) return true;	18✔
293	return depluralize(a).equalsIgnoreCase(depluralize(b));	18✔
294	}
295
296	private static String depluralize(String word) {
297	return word.length() > 1 && (word.endsWith("s") \|\| word.endsWith("S"))	39!
298	? word.substring(0, word.length() - 1)	24✔
299	: word;	3✔
300	}
301
302	/**
303	* Places a resource tab strip (Content \| About \| Raw) on the right side of
304	* the breadcrumb strip, and forces the strip visible so the tabs show even on
305	* pages without a breadcrumb (e.g. user pages). Returns {@code this} for
306	* fluent use at the {@code add(...)} call site.
307	*
308	* @param tabs the tab strip (its markup id must be {@code "tabs"})
309	* @return this TitleBar
310	*/
311	public TitleBar setTabs(ResourceTabs tabs) {
312	breadcrumbPath.addOrReplace(tabs);	×
313	breadcrumbPath.setVisible(true);	×
314	return this;	×
315	}
316
317	private BookmarkablePageLink<Void> createNavLink(String id, Class<? extends WebPage> pageClass, PageParameters params) {
318	BookmarkablePageLink<Void> link = new BookmarkablePageLink<>(id, pageClass, params);	21✔
319	if (id.equals(highlight)) {	15!
320	link.add(new AttributeAppender("class", "selected"));	×
321	}
322	add(link);	27✔
323	return link;	6✔
324	}
325
326	}

knowledgepixels / nanodash / 28788771886

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous