diff --git a/README.md b/README.md
index e940757c..cb671915 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,22 @@ This repo contains the source files for the [LizardByte](https://app.lizardbyte.
The page is built using jekyll and hosted on GitHub Pages.
+### Project discovery
+
+The Projects section reads public repository data from dashboard's `github/repos.json` and the
+[organization registry](https://github.com/LizardByte/.github/blob/master/organizations.json).
+The registry drives organization filtering and the archived-project search. Project search matches
+repository names, organizations, and descriptions; each card shows its organization.
+
+This consumer requires the multi-org dashboard catalog: banners use `dashboard_paths.banner_small`,
+activity and languages use `dashboard_key`, and Read the Docs links match `dashboard_aliases`.
+Transfers and renames therefore retain the existing asset URLs. Filtering reuses the rendered cards
+without fetching their assets again.
+
+Project titles and banners link to a repository's HTTP(S) `homepage`, or its GitHub page when no valid
+homepage is configured. Set that field to the project's public site, including its new subdomain.
+The consumer does not infer a site URL from an organization or repository name.
+
### CrowdIn Localization
diff --git a/assets/js/projects.js b/assets/js/projects.js
index f1e2dd7e..b5f46a71 100644
--- a/assets/js/projects.js
+++ b/assets/js/projects.js
@@ -5,6 +5,7 @@ let container
let org_name = "LizardByte"
let base_url = `https://app.${org_name.toLowerCase()}.dev`
let cache_repo = "dashboard"
+const organizations_url = "https://raw.githubusercontent.com/LizardByte/.github/master/organizations.json"
let shared_web_url = "https://cdn.jsdelivr.net/npm/@lizardbyte/shared-web@2026.1107.31840"
@@ -36,28 +37,51 @@ function fetchJson(url) {
}
function shouldProcessRepo(repo) {
+ if (repo['private'] === true) return false;
if (repo['archived'] === true) return false;
if (repo['description'] === null) return false;
return !(repo['fork'] === true && !repo['topics'].includes("featured-fork"));
}
+function projectUrl(repo) {
+ try {
+ const homepage = new URL(repo.homepage)
+ if (["https:", "http:"].includes(homepage.protocol)) return homepage.href
+ } catch {
+ // Repositories without a valid homepage link to GitHub.
+ }
+ return repo.html_url
+}
+
+function githubIdentity(value) {
+ try {
+ const url = new URL(value.replace(/^git@github\.com:/i, "https://github.com/"))
+ const parts = url.pathname.split("/").filter(Boolean)
+ if (url.hostname !== "github.com" || parts.length !== 2) return null
+ return parts.join("/").replace(/\.git$/i, "").toLowerCase()
+ } catch {
+ return null
+ }
+}
+
function createBannerElement(repo) {
let banner_div = document.createElement("div")
banner_div.className = "hover-zoom"
let banner_link = document.createElement("a")
banner_link.className = "crowdin-ignore"
- banner_link.href = repo['html_url']
+ banner_link.href = projectUrl(repo)
banner_link.target = "_blank"
+ banner_link.rel = "noopener noreferrer"
banner_div.append(banner_link)
let banner = document.createElement("img")
banner.className = "card-img-top rounded-0"
- banner.src = `${base_url}/${cache_repo}/github/openGraphImages/${repo['name']}_624x312.png`
+ banner.src = `${base_url}/${cache_repo}/${repo.dashboard_paths.banner_small}`
banner.alt = ""
banner_link.append(banner)
- return { banner_div, banner_link }
+ return banner_div
}
function createCardBody(repo) {
@@ -66,8 +90,9 @@ function createCardBody(repo) {
let card_title_link = document.createElement("a")
card_title_link.className = "text-decoration-none project-card-link crowdin-ignore"
- card_title_link.href = repo['html_url']
+ card_title_link.href = projectUrl(repo)
card_title_link.target = "_blank"
+ card_title_link.rel = "noopener noreferrer"
card_body.appendChild(card_title_link)
let card_title_text = document.createElement("h5")
@@ -83,16 +108,21 @@ function createCardBody(repo) {
card_title_link.appendChild(card_title_text)
+ const organization = document.createElement("p")
+ organization.className = "project-organization small text-muted crowdin-ignore"
+ organization.textContent = repo.owner.login
+ card_body.appendChild(organization)
+
let card_paragraph = document.createElement("p")
card_paragraph.className = "card-text mb-0"
card_paragraph.textContent = repo['description']
card_body.appendChild(card_paragraph)
- return { card_body, card_title_link }
+ return card_body
}
function loadCommitActivity(repo, card_footer) {
- fetchJson(`${base_url}/${cache_repo}/github/commitActivity/${repo['name']}.json`)
+ fetchJson(`${base_url}/${cache_repo}/github/commitActivity/${repo.dashboard_key}.json`)
.then(function (commitActivity) {
let activity_container = document.createElement("div")
activity_container.className = "commit-activity-graph mt-2 mb-2 mx-3"
@@ -125,7 +155,7 @@ function loadCommitActivity(repo, card_footer) {
})
}
-function createRepoDataRow(repo, card_footer, banner_link, card_title_link) {
+function createRepoDataRow(repo, card_footer) {
let repo_data_row = document.createElement("div")
repo_data_row.className = "d-flex align-items-center"
card_footer.appendChild(repo_data_row)
@@ -140,15 +170,6 @@ function createRepoDataRow(repo, card_footer, banner_link, card_title_link) {
github_link_image.className = "fa-fw fa-brands fa-github"
github_link.prepend(github_link_image)
- fetchWithNoCache(`${base_url}/${repo['name']}/`)
- .then(function (response) {
- if (!response.ok) return
-
- banner_link.href = `${base_url}/${repo['name']}/`
- card_title_link.href = `${base_url}/${repo['name']}/`
- })
- .catch(function () {})
-
let star_link = document.createElement("a")
star_link.className = "nav-link nav-link-sm project-nav-link ms-3 crowdin-ignore"
star_link.href = `https://star-history.com/#${repo['full_name']}`
@@ -176,10 +197,8 @@ function createRepoDataRow(repo, card_footer, banner_link, card_title_link) {
function addDocsLink(repo, readthedocs, repo_data_row) {
for (let docs in readthedocs) {
- let docs_repo = readthedocs[docs]['repository']['url'].toLowerCase();
- let project_repo = repo['clone_url'].toLowerCase();
-
- if (docs_repo !== project_repo) continue;
+ const docs_repo = githubIdentity(readthedocs[docs]['repository']['url']);
+ if (!repo.dashboard_aliases.some(alias => alias.toLowerCase() === docs_repo)) continue;
let docs_url = readthedocs[docs]['urls']['documentation']
try {
@@ -208,7 +227,7 @@ function addDocsLink(repo, readthedocs, repo_data_row) {
}
function loadLanguageIcons(repo, card_footer) {
- fetchJson(`${base_url}/${cache_repo}/github/languages/${repo['name']}.json`)
+ fetchJson(`${base_url}/${cache_repo}/github/languages/${repo.dashboard_key}.json`)
.then(function (languages) {
let language_data_row = document.createElement("div")
language_data_row.className = "card-group p-3 align-items-center"
@@ -236,11 +255,9 @@ function buildRepoCard(repo, readthedocs) {
card.className = "card h-100 shadow border-0 rounded-0"
column.appendChild(card)
- let { banner_div, banner_link } = createBannerElement(repo)
- card.append(banner_div)
+ card.append(createBannerElement(repo))
- let { card_body, card_title_link } = createCardBody(repo)
- card.appendChild(card_body)
+ card.appendChild(createCardBody(repo))
let card_footer = document.createElement("div")
card_footer.className = "card-footer p-2 pt-0 border-0 rounded-0"
@@ -248,9 +265,57 @@ function buildRepoCard(repo, readthedocs) {
loadCommitActivity(repo, card_footer)
- let repo_data_row = createRepoDataRow(repo, card_footer, banner_link, card_title_link)
+ let repo_data_row = createRepoDataRow(repo, card_footer)
addDocsLink(repo, readthedocs, repo_data_row)
loadLanguageIcons(repo, card_footer)
+ return column
+}
+
+function updateProjectFilters(cards, organizations) {
+ const organization = document.getElementById("project-organization").value
+ const terms = document.getElementById("project-search").value.toLowerCase().trim().split(/\s+/).filter(Boolean)
+ let count = 0
+ for (const { repo, column } of cards) {
+ const text = `${repo.full_name} ${repo.description}`.toLowerCase()
+ const matches = (!organization || repo.owner.login.toLowerCase() === organization.toLowerCase())
+ && terms.every(term => text.includes(term))
+ column.hidden = !matches
+ if (matches) count += 1
+ }
+ const noun = count === 1 ? "project" : "projects"
+ document.getElementById("project-status").textContent = count
+ ? `${count} ${noun}` : "No projects match your search."
+
+ const scope = organization ? [organization] : organizations
+ const query = [...scope.map(name => `org:${name}`), "archived:true"].join(" ")
+ const archive = document.getElementById("archived-projects-link")
+ archive.href = `https://github.com/search?${new URLSearchParams({ q: query, type: "repositories" })}`
+ archive.classList.remove("disabled")
+ archive.removeAttribute("aria-disabled")
+}
+
+function createProjectBrowser(repos, readthedocs, organizations) {
+ if (!Array.isArray(organizations) || !organizations.length
+ || organizations.some(name => typeof name !== "string" || !/^[a-z\d][a-z\d-]*$/i.test(name))) {
+ throw new Error("Invalid organization registry")
+ }
+ const organization = document.getElementById("project-organization")
+ organizations.sort((left, right) => left.localeCompare(right))
+ for (const name of organizations) {
+ organization.add(new Option(name, name))
+ }
+ const registered = new Set(organizations.map(name => name.toLowerCase()))
+ const sorted = repos.filter(repo => registered.has(repo.owner.login.toLowerCase()) && shouldProcessRepo(repo))
+ .sort(globalThis.rankingSorter("stargazers_count", "full_name"))
+ // Build each card once so filtering does not fetch its assets again.
+ const cards = sorted.map(repo => ({ repo, column: buildRepoCard(repo, readthedocs) }))
+ const update = () => updateProjectFilters(cards, organizations)
+ const search = document.getElementById("project-search")
+ organization.disabled = false
+ search.disabled = false
+ organization.addEventListener("change", update)
+ search.addEventListener("input", update)
+ update()
}
@@ -269,18 +334,14 @@ onDocumentReady(function () {
})
let reposRequest = fetchJson(`${base_url}/${cache_repo}/github/repos.json`)
+ let organizationsRequest = fetchJson(organizations_url)
- Promise.all([readthedocsRequest, reposRequest])
- .then(function ([readthedocs, result]) {
- let sorted = result.sort(globalThis.rankingSorter("stargazers_count", "name"))
-
- for (let repo of sorted) {
- if (shouldProcessRepo(repo)) {
- buildRepoCard(repo, readthedocs)
- }
- }
+ Promise.all([readthedocsRequest, reposRequest, organizationsRequest])
+ .then(function ([readthedocs, result, organizations]) {
+ createProjectBrowser(result, readthedocs, organizations)
})
.catch(function (error) {
+ document.getElementById("project-status").textContent = "Projects could not be loaded. Please try again later."
console.error("Error loading project data:", error)
})
})
diff --git a/eslint.config.mjs b/eslint.config.mjs
index 5b26d0f6..b088eebe 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -11,7 +11,7 @@ export default [
],
},
{
- files: ['assets/js/release-versions.js'],
+ files: ['assets/js/release-versions.js', 'assets/js/projects.js'],
languageOptions: {
globals: {
...globals.browser,
diff --git a/index.html b/index.html
index b60bec27..96583465 100644
--- a/index.html
+++ b/index.html
@@ -71,11 +71,27 @@
diff --git a/package.json b/package.json
index fd37ed46..132f7cbb 100644
--- a/package.json
+++ b/package.json
@@ -26,7 +26,7 @@
"scripts": {
"build": "echo \"No Node.js build step required\"",
"test": "npm-run-all test:unit test:report test:lint",
- "test:lint": "eslint assets/js/release-versions.js tests",
+ "test:lint": "eslint assets/js/release-versions.js assets/js/projects.js tests",
"test:report": "jest --reporters=jest-junit",
"test:unit": "jest --coverage"
},
diff --git a/tests/projects.test.cjs b/tests/projects.test.cjs
index 368a9803..1d2c7212 100644
--- a/tests/projects.test.cjs
+++ b/tests/projects.test.cjs
@@ -1,6 +1,11 @@
/** @jest-environment jsdom */
-const { afterEach, describe, expect, test } = require('@jest/globals');
+const { afterEach, beforeEach, describe, expect, test } = require('@jest/globals');
+const { readFileSync } = require('node:fs');
+const { join } = require('node:path');
+
+const registryUrl = 'https://raw.githubusercontent.com/LizardByte/.github/master/organizations.json';
+const dashboardUrl = 'https://app.lizardbyte.dev/dashboard';
function loadScript() {
jest.resetModules();
@@ -10,9 +15,7 @@ function loadScript() {
function captureDomReady() {
let callback;
const addEventListener = jest.spyOn(document, 'addEventListener').mockImplementation((type, listener) => {
- if (type === 'DOMContentLoaded') {
- callback = listener;
- }
+ if (type === 'DOMContentLoaded') callback = listener;
});
loadScript();
addEventListener.mockRestore();
@@ -23,20 +26,68 @@ function setReadyState(value) {
return jest.spyOn(document, 'readyState', 'get').mockReturnValue(value);
}
-async function flushPromises(rounds = 8) {
- for (let index = 0; index < rounds; index += 1) {
- await Promise.resolve();
- }
+async function flushPromises(rounds = 12) {
+ for (let index = 0; index < rounds; index += 1) await Promise.resolve();
}
function response(body, ok = true, status = 200) {
+ return { json: jest.fn().mockResolvedValue(body), ok, status };
+}
+
+function project(name, { organization = 'LizardByte', ...overrides } = {}) {
+ const fullName = `${organization}/${name}`;
return {
- json: jest.fn().mockResolvedValue(body),
- ok,
- status,
+ archived: false,
+ private: false,
+ clone_url: `https://github.com/${fullName}.git`,
+ description: 'Project description',
+ fork: false,
+ forks: 2,
+ full_name: fullName,
+ html_url: `https://github.com/${fullName}`,
+ homepage: null,
+ name,
+ owner: { login: organization },
+ stargazers_count: 20,
+ topics: [],
+ dashboard_key: fullName,
+ dashboard_aliases: [fullName],
+ dashboard_paths: { banner_small: `github/openGraphImages/${fullName}_624x312.png` },
+ ...overrides,
};
}
+function catalogFetch(repos, organizations, docs = []) {
+ return jest.fn(url => {
+ if (url === registryUrl) return Promise.resolve(response(organizations));
+ if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(docs));
+ if (url.endsWith('/github/repos.json')) return Promise.resolve(response(repos));
+ if (url.includes('/commitActivity/')) return Promise.resolve(response([{ total: 1 }]));
+ if (url.includes('/languages/')) return Promise.resolve(response({}));
+ throw new Error(`Unexpected URL: ${url}`);
+ });
+}
+
+function visibleCards() {
+ return [...document.querySelectorAll('#project-container > div')].filter(card => !card.hidden);
+}
+
+function change(id, value, event) {
+ const element = document.getElementById(id);
+ element.value = value;
+ element.dispatchEvent(new Event(event));
+}
+
+beforeEach(() => {
+ setReadyState('complete');
+ const index = readFileSync(join(__dirname, '../index.html'), 'utf8');
+ document.body.innerHTML = index.slice(index.indexOf(''));
+ globalThis.formatNumber = jest.fn(value => `#${value}`);
+ globalThis.rankingSorter = jest.fn(() => (left, right) => right.stargazers_count - left.stargazers_count);
+ jest.spyOn(console, 'error').mockImplementation(() => {});
+ jest.spyOn(console, 'log').mockImplementation(() => {});
+});
+
afterEach(() => {
document.body.innerHTML = '';
delete globalThis.fetch;
@@ -47,86 +98,53 @@ afterEach(() => {
describe('project cards', () => {
test('waits for DOM readiness and exits when the project container is absent', () => {
- const readyState = setReadyState('loading');
+ document.body.innerHTML = '';
+ setReadyState('loading');
globalThis.fetch = jest.fn();
const onReady = captureDomReady();
expect(globalThis.fetch).not.toHaveBeenCalled();
-
onReady();
expect(globalThis.fetch).not.toHaveBeenCalled();
- readyState.mockRestore();
});
- test('filters repositories and builds cards with activity, docs, and language data', async () => {
- setReadyState('complete');
- document.body.innerHTML = '
';
- globalThis.formatNumber = jest.fn(value => `#${value}`);
- globalThis.rankingSorter = jest.fn(() => (left, right) => right.stargazers_count - left.stargazers_count);
- jest.spyOn(console, 'error').mockImplementation(() => {});
- jest.spyOn(console, 'log').mockImplementation(() => {});
-
- const normal = {
- archived: false,
- clone_url: 'https://github.com/LizardByte/normal.git',
- description: 'Normal project',
- fork: false,
- forks: 2,
- full_name: 'LizardByte/normal',
- html_url: 'https://github.com/LizardByte/normal',
- name: 'normal',
- stargazers_count: 20,
- topics: [],
- };
- const featured = {
- ...normal,
- clone_url: 'https://github.com/LizardByte/featured.git',
- description: 'Featured fork',
- fork: true,
- full_name: 'LizardByte/featured',
- name: 'featured',
- stargazers_count: 10,
- topics: ['featured-fork'],
- };
- const zero = {
- ...normal,
- clone_url: 'https://github.com/LizardByte/zero.git',
- description: 'Zero activity',
- full_name: 'LizardByte/zero',
- name: 'zero',
- stargazers_count: 5,
- };
+ test('filters repositories and uses explicit asset paths, stable keys, and pre-transfer docs aliases', async () => {
+ const normal = project('normal', {
+ homepage: 'https://sunshine.lizardbyte.dev/',
+ dashboard_key: 'former-name',
+ dashboard_aliases: ['OldOrg/former-name', 'LizardByte/normal'],
+ dashboard_paths: { banner_small: 'github/openGraphImages/former-banner_624x312.png' },
+ });
+ const featured = project('featured', {
+ fork: true, stargazers_count: 10, topics: ['featured-fork'], homepage: 'javascript:alert(1)',
+ });
+ const zero = project('zero', { stargazers_count: 5 });
const skipped = [
- { ...normal, archived: true, name: 'archived' },
- { ...normal, description: null, name: 'undocumented' },
- { ...normal, fork: true, name: 'plain-fork', topics: [] },
+ project('archived', { archived: true }),
+ project('private', { private: true }),
+ project('undocumented', { description: null }),
+ project('plain-fork', { fork: true }),
+ project('unregistered', { organization: 'Unknown' }),
];
const docs = {
bad: { repository: { url: featured.clone_url }, urls: { documentation: 'not a URL' } },
external: { repository: { url: featured.clone_url }, urls: { documentation: 'https://example.com/docs' } },
- good: { repository: { url: normal.clone_url.toUpperCase() }, urls: { documentation: 'https://docs.lizardbyte.dev/projects/normal' } },
+ good: { repository: { url: 'https://github.com/OldOrg/FORMER-NAME.git/' }, urls: { documentation: 'https://docs.lizardbyte.dev/projects/normal' } },
other: { repository: { url: 'https://github.com/Other/project.git' }, urls: { documentation: 'https://docs.lizardbyte.dev/other' } },
};
-
+ const baseFetch = catalogFetch([...skipped, zero, featured, normal], ['LizardByte'], docs);
globalThis.fetch = jest.fn(url => {
- if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(docs));
- if (url.endsWith('/github/repos.json')) return Promise.resolve(response([...skipped, zero, featured, normal]));
- if (url.includes('/commitActivity/normal.json')) return Promise.resolve(response([{ total: 0 }, { total: 5 }, { total: 10 }]));
- if (url.includes('/commitActivity/featured.json')) return Promise.reject(new Error('no activity'));
- if (url.includes('/commitActivity/zero.json')) return Promise.resolve(response([{ total: 0 }]));
- if (url.includes('/languages/normal.json')) return Promise.resolve(response({ 'C++': 90, JavaScript: 10 }));
- if (url.includes('/languages/featured.json')) return Promise.resolve(response(null, false, 404));
- if (url.includes('/languages/zero.json')) return Promise.reject(new Error('no languages'));
- if (url.endsWith('/normal/')) return Promise.resolve(response(null));
- if (url.endsWith('/featured/')) return Promise.resolve(response(null, false, 404));
- if (url.endsWith('/zero/')) return Promise.reject(new Error('site unavailable'));
- throw new Error(`Unexpected URL: ${url}`);
+ if (url.includes('/commitActivity/former-name.json')) return Promise.resolve(response([{ total: 0 }, { total: 5 }, { total: 10 }]));
+ if (url.includes('/commitActivity/LizardByte/featured.json')) return Promise.reject(new Error('no activity'));
+ if (url.includes('/commitActivity/LizardByte/zero.json')) return Promise.resolve(response([{ total: 0 }]));
+ if (url.includes('/languages/former-name.json')) return Promise.resolve(response({ 'C++': 90, JavaScript: 10 }));
+ if (url.includes('/languages/LizardByte/featured.json')) return Promise.resolve(response(null, false, 404));
+ if (url.includes('/languages/LizardByte/zero.json')) return Promise.reject(new Error('no languages'));
+ return baseFetch(url);
});
loadScript();
await flushPromises(20);
-
- const cards = document.querySelectorAll('#project-container > div');
- expect(cards).toHaveLength(3);
+ expect(visibleCards()).toHaveLength(3);
expect(document.querySelectorAll('.badge.bg-info')).toHaveLength(1);
expect(document.querySelector('.readthedocs-icon').closest('a').href).toBe('https://docs.lizardbyte.dev/projects/normal');
expect(document.querySelectorAll('.language-logo')).toHaveLength(2);
@@ -135,28 +153,129 @@ describe('project cards', () => {
expect(activeBars).toHaveLength(2);
expect(Number(activeBars[0].style.getPropertyValue('--commit-bar-opacity'))).toBeCloseTo(0.65);
expect(Number(activeBars[1].style.getPropertyValue('--commit-bar-opacity'))).toBe(1);
- expect(activeBars[0].style.opacity).toBe('');
expect(document.querySelectorAll('.commit-bar-empty')).toHaveLength(2);
- expect(document.querySelector('a[href="https://app.lizardbyte.dev/normal/"]')).not.toBeNull();
- expect(globalThis.formatNumber).toHaveBeenCalled();
+ expect(document.querySelector('.card-img-top').src).toBe(`${dashboardUrl}/github/openGraphImages/former-banner_624x312.png`);
+ expect(document.querySelector('.project-card-link').href).toBe(normal.homepage);
+ expect(visibleCards()[1].querySelector('.project-card-link').href).toBe(featured.html_url);
+ expect(visibleCards()[2].querySelector('.project-card-link').href).toBe(zero.html_url);
+ expect(document.getElementById('project-status').textContent).toBe('3 projects');
+ expect(globalThis.rankingSorter).toHaveBeenCalledWith('stargazers_count', 'full_name');
+ expect(baseFetch.mock.calls.every(([url]) => url === registryUrl || url.startsWith(dashboardUrl))).toBe(true);
+ });
+
+ test('distinguishes same-name repos, searches across orgs, and scopes archived search without refetching cards', async () => {
+ const first = project('demo', { organization: 'First', dashboard_key: 'original-demo' });
+ const second = project('demo', { organization: 'Second' });
+ const future = project('audio', { organization: 'FutureOrg', description: 'Movie themes' });
+ globalThis.fetch = catalogFetch([first, second, future], ['FutureOrg', 'second', 'First', 'Empty']);
+ loadScript();
+ await flushPromises();
+
+ const cards = visibleCards();
+ expect(cards).toHaveLength(3);
+ expect(cards.map(card => card.querySelector('.project-organization').textContent)).toEqual(['First', 'Second', 'FutureOrg']);
+ expect(cards[0].querySelector('.card-img-top').src).toContain('/First/demo_624x312.png');
+ expect(cards[1].querySelector('.card-img-top').src).toContain('/Second/demo_624x312.png');
+ const urls = globalThis.fetch.mock.calls.map(([url]) => url);
+ expect(urls).toContain(`${dashboardUrl}/github/commitActivity/original-demo.json`);
+ expect(urls).toContain(`${dashboardUrl}/github/languages/Second/demo.json`);
expect(globalThis.fetch.mock.calls.every(([, options]) => options.cache === 'no-store')).toBe(true);
+ expect([...document.getElementById('project-organization').options].map(option => option.value))
+ .toEqual(['', 'Empty', 'First', 'FutureOrg', 'second']);
+ const requests = globalThis.fetch.mock.calls.length;
+ change('project-organization', 'First', 'change');
+ expect(visibleCards()).toHaveLength(1);
+ expect(document.getElementById('project-status').textContent).toBe('1 project');
+ change('project-search', 'SECOND DEMO', 'input');
+ expect(visibleCards()).toHaveLength(0);
+ expect(document.getElementById('project-status').textContent).toBe('No projects match your search.');
+ change('project-organization', '', 'change');
+ expect(visibleCards()).toHaveLength(1);
+ expect(visibleCards()[0].querySelector('.project-organization').textContent).toBe('Second');
+ change('project-search', ' movie THEMES ', 'input');
+ expect(visibleCards()).toHaveLength(1);
+ expect(visibleCards()[0].querySelector('.card-title').textContent).toBe('audio');
+ change('project-organization', 'Empty', 'change');
+ expect(visibleCards()).toHaveLength(0);
+ const archive = document.getElementById('archived-projects-link');
+ expect(new URL(archive.href).searchParams.get('q')).toBe('org:Empty archived:true');
+ change('project-organization', '', 'change');
+ change('project-search', '', 'input');
+ expect(visibleCards()).toHaveLength(3);
+ expect(new URL(archive.href).searchParams.get('q')).toBe('org:Empty org:First org:FutureOrg org:second archived:true');
+ expect(new URL(archive.href).searchParams.get('type')).toBe('repositories');
+ expect(archive.classList.contains('disabled')).toBe(false);
+ expect(globalThis.fetch).toHaveBeenCalledTimes(requests);
+ });
+
+ test('keeps a transferred and renamed project on the supplied cache paths', async () => {
+ const moved = project('renamed', {
+ organization: 'SunshineStream', dashboard_key: 'Sunshine',
+ dashboard_paths: { banner_small: 'github/openGraphImages/Sunshine_624x312.png' },
+ });
+ globalThis.fetch = catalogFetch([moved], ['SunshineStream']);
+ loadScript();
+ await flushPromises();
+ expect(document.querySelector('.card-img-top').src).toBe(`${dashboardUrl}/github/openGraphImages/Sunshine_624x312.png`);
+ expect(globalThis.fetch).toHaveBeenCalledWith(`${dashboardUrl}/github/commitActivity/Sunshine.json`, expect.any(Object));
+ expect(globalThis.fetch).toHaveBeenCalledWith(`${dashboardUrl}/github/languages/Sunshine.json`, expect.any(Object));
+ });
+
+ test('normalizes HTTPS and SSH docs identities without matching another org by basename', async () => {
+ const moved = project('demo', { organization: 'New', dashboard_aliases: ['Old/demo', 'New/demo'] });
+ const other = project('demo', { organization: 'Other' });
+ const docs = [
+ 'git@github.com:Old/demo.git', 'ssh://git@github.com/Old/demo.git', 'https://github.com/New/demo',
+ 'not a URL', 'https://example.com/Old/demo', 'https://github.com/Old',
+ ].map((url, index) => ({ repository: { url }, urls: { documentation: `https://docs.lizardbyte.dev/${index}` } }));
+ globalThis.fetch = catalogFetch([moved, other], ['New', 'Other'], docs);
+ loadScript();
+ await flushPromises();
+ expect(visibleCards()[0].querySelectorAll('.readthedocs-icon')).toHaveLength(3);
+ expect(visibleCards()[1].querySelectorAll('.readthedocs-icon')).toHaveLength(0);
});
- test('continues without documentation data and reports repository failures', async () => {
- setReadyState('complete');
- document.body.innerHTML = '
';
- globalThis.formatNumber = value => String(value);
- globalThis.rankingSorter = () => () => 0;
- const consoleLog = jest.spyOn(console, 'log').mockImplementation(() => {});
- const consoleError = jest.spyOn(console, 'error').mockImplementation(() => {});
+ test.each(['http://sunshine.lizardbyte.dev/', 'https://koko.lizardbyte.dev/custom/path/'])(
+ 'uses the configured project homepage %s without probing the umbrella domain', async homepage => {
+ globalThis.fetch = catalogFetch([project('demo', { homepage })], ['LizardByte']);
+ loadScript();
+ await flushPromises();
+ expect(document.querySelector('.project-card-link').href).toBe(homepage);
+ expect(globalThis.fetch.mock.calls.some(([url]) => url === homepage)).toBe(false);
+ },
+ );
+ test.each([null, [], [''], [42], ['invalid/name']].map(value => [value]))(
+ 'rejects an invalid registry: %j', async organizations => {
+ globalThis.fetch = catalogFetch([], organizations);
+ loadScript();
+ await flushPromises();
+ expect(document.getElementById('project-status').textContent).toContain('could not be loaded');
+ expect(document.getElementById('project-organization').disabled).toBe(true);
+ expect(document.getElementById('archived-projects-link').hasAttribute('href')).toBe(false);
+ },
+ );
+
+ test('continues without docs data and reports repository failures', async () => {
globalThis.fetch = jest.fn(url => {
+ if (url === registryUrl) return Promise.resolve(response(['LizardByte']));
if (url.endsWith('/readthedocs/projects.json')) return Promise.resolve(response(null, false, 500));
return Promise.resolve(response(null, false, 503));
});
loadScript();
await flushPromises();
- expect(consoleLog).toHaveBeenCalledWith('No ReadTheDocs project data available', expect.any(Error));
- expect(consoleError).toHaveBeenCalledWith('Error loading project data:', expect.any(Error));
+ expect(console.log).toHaveBeenCalledWith('No ReadTheDocs project data available', expect.any(Error));
+ expect(console.error).toHaveBeenCalledWith('Error loading project data:', expect.any(Error));
+ expect(document.getElementById('project-status').textContent).toContain('could not be loaded');
+ });
+
+ test('a registry outage does not create an unscoped archive link', async () => {
+ const baseFetch = catalogFetch([], ['LizardByte']);
+ globalThis.fetch = jest.fn(url => url === registryUrl
+ ? Promise.resolve(response(null, false, 503)) : baseFetch(url));
+ loadScript();
+ await flushPromises();
+ expect(document.getElementById('project-search').disabled).toBe(true);
+ expect(document.getElementById('archived-projects-link').hasAttribute('href')).toBe(false);
});
});