From f0fe8af971d1f37bc26ac988e43e389775dfd3c1 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 24 Mar 2026 15:08:45 +0000 Subject: [PATCH 1/3] fix: correct docs asset paths for github pages Co-authored-by: JosunLP <20913954+JosunLP@users.noreply.github.com> Agent-Logs-Url: https://github.com/bQuery/ui/sessions/cd21d1b0-1a06-4652-9c77-c99cdd62bd30 --- docs/.vitepress/config.ts | 5 +++-- tests/docs-config.test.ts | 12 ++++++++++++ 2 files changed, 15 insertions(+), 2 deletions(-) create mode 100644 tests/docs-config.test.ts diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 6467786..2a51344 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -1,11 +1,12 @@ import { defineConfig } from 'vitepress'; +const githubPagesBase = `/${process.env.GITHUB_REPOSITORY?.split('/')[1] ?? 'ui'}/`; + export default defineConfig({ title: '@bquery/ui', description: 'Production-grade web component library for the bQuery project', - base: '/', + base: githubPagesBase, themeConfig: { - logo: '/logo.svg', nav: [ { text: 'Guide', link: '/guide/getting-started' }, { text: 'Components', link: '/components/' }, diff --git a/tests/docs-config.test.ts b/tests/docs-config.test.ts new file mode 100644 index 0000000..5179000 --- /dev/null +++ b/tests/docs-config.test.ts @@ -0,0 +1,12 @@ +import { describe, expect, it } from 'bun:test'; +import config from '../docs/.vitepress/config.ts'; + +describe('docs config', () => { + it('uses the repository base path for GitHub Pages assets', () => { + expect(config.base).toBe('/ui/'); + }); + + it('does not reference a missing docs logo asset', () => { + expect((config.themeConfig as { logo?: string }).logo).toBeUndefined(); + }); +}); From cb44a305becfc1e00017016fefa329235049d48a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 24 Mar 2026 15:10:36 +0000 Subject: [PATCH 2/3] chore: finalize docs pages validation Co-authored-by: JosunLP <20913954+JosunLP@users.noreply.github.com> Agent-Logs-Url: https://github.com/bQuery/ui/sessions/cd21d1b0-1a06-4652-9c77-c99cdd62bd30 --- docs/.vitepress/config.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 2a51344..2758b8e 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -1,11 +1,11 @@ import { defineConfig } from 'vitepress'; -const githubPagesBase = `/${process.env.GITHUB_REPOSITORY?.split('/')[1] ?? 'ui'}/`; +const repositoryBasePath = `/${process.env.GITHUB_REPOSITORY?.split('/')[1] ?? 'ui'}/`; export default defineConfig({ title: '@bquery/ui', description: 'Production-grade web component library for the bQuery project', - base: githubPagesBase, + base: repositoryBasePath, themeConfig: { nav: [ { text: 'Guide', link: '/guide/getting-started' }, From 024b1f0817e91cdae231205d7136a84f020290e5 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 24 Mar 2026 15:28:51 +0000 Subject: [PATCH 3/3] fix: refine docs base resolution for local and pages builds Co-authored-by: JosunLP <20913954+JosunLP@users.noreply.github.com> Agent-Logs-Url: https://github.com/bQuery/ui/sessions/24bfda23-9a9b-4168-bfd4-ca2fe085b9cb --- docs/.vitepress/config.ts | 17 ++++++++++++++++- tests/docs-config.test.ts | 23 ++++++++++++++++++++--- 2 files changed, 36 insertions(+), 4 deletions(-) diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 2758b8e..62a3de2 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -1,6 +1,21 @@ import { defineConfig } from 'vitepress'; -const repositoryBasePath = `/${process.env.GITHUB_REPOSITORY?.split('/')[1] ?? 'ui'}/`; +export function resolveDocsBase(env: NodeJS.ProcessEnv = process.env): string { + const explicitBase = env.DOCS_BASE ?? env.VITEPRESS_BASE; + + if (explicitBase) { + return explicitBase; + } + + const repositoryName = + env.GITHUB_ACTIONS === 'true' + ? env.GITHUB_REPOSITORY?.split('/')[1] + : undefined; + + return repositoryName ? `/${repositoryName}/` : '/'; +} + +const repositoryBasePath = resolveDocsBase(); export default defineConfig({ title: '@bquery/ui', diff --git a/tests/docs-config.test.ts b/tests/docs-config.test.ts index 5179000..b319acd 100644 --- a/tests/docs-config.test.ts +++ b/tests/docs-config.test.ts @@ -1,9 +1,26 @@ import { describe, expect, it } from 'bun:test'; -import config from '../docs/.vitepress/config.ts'; +import config, { resolveDocsBase } from '../docs/.vitepress/config.ts'; describe('docs config', () => { - it('uses the repository base path for GitHub Pages assets', () => { - expect(config.base).toBe('/ui/'); + it('defaults to the site root outside GitHub Pages builds', () => { + expect(resolveDocsBase({})).toBe('/'); + }); + + it('uses the repository base path for GitHub Pages assets in GitHub Actions', () => { + expect( + resolveDocsBase({ + GITHUB_ACTIONS: 'true', + GITHUB_REPOSITORY: 'bQuery/ui', + }) + ).toBe('/ui/'); + }); + + it('allows overriding the docs base explicitly', () => { + expect(resolveDocsBase({ DOCS_BASE: '/preview/' })).toBe('/preview/'); + }); + + it('wires the exported config to the resolved docs base', () => { + expect(config.base).toBe(resolveDocsBase()); }); it('does not reference a missing docs logo asset', () => {