-
+
+
+
+
+
+
+
+
+
+ {{ seriesPositionLabel }}
+
+
+
+ {{ seriesPositionTooltip }}
+
+
diff --git a/client/src/features/book/components/__tests__/BookCoverCard.spec.ts b/client/src/features/book/components/__tests__/BookCoverCard.spec.ts
index 2e5704c36..5de77f3ad 100644
--- a/client/src/features/book/components/__tests__/BookCoverCard.spec.ts
+++ b/client/src/features/book/components/__tests__/BookCoverCard.spec.ts
@@ -40,6 +40,9 @@ const globalStubs = {
DropdownMenuSub: { template: '
' },
DropdownMenuSubTrigger: { template: '
' },
DropdownMenuSubContent: { template: '
' },
+ Tooltip: { template: '
' },
+ TooltipTrigger: { template: '
' },
+ TooltipContent: { template: '
' },
},
}
@@ -243,3 +246,69 @@ describe('BookCoverCard — placeholder state', () => {
expect(imgs.length).toBeGreaterThan(0)
})
})
+
+describe('BookCoverCard — series position overlay', () => {
+ const bookWithSeries: BookCard = {
+ ...presentBook,
+ seriesName: 'The Expanse',
+ seriesIndex: 3,
+ }
+
+ afterEach(() => {
+ cardOverlays.value = ['progress-bar', 'format', 'rating', 'read-status']
+ })
+
+ it('renders the series badge when overlay is enabled and seriesIndex is set', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard(bookWithSeries)
+ expect(wrapper.text()).toContain('#3')
+ })
+
+ it('does not render the badge when series-position is not in overlays', () => {
+ cardOverlays.value = []
+ const wrapper = mountCard(bookWithSeries)
+ expect(wrapper.text()).not.toContain('#3')
+ })
+
+ it('does not render badge when seriesIndex is null', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard({ ...presentBook, seriesIndex: null, seriesName: 'Dune' })
+ expect(wrapper.text()).not.toContain('#')
+ })
+
+ it('formats whole-number float 3.0 as #3 (no trailing decimal)', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard({ ...presentBook, seriesIndex: 3.0, seriesName: 'Dune' })
+ expect(wrapper.text()).toContain('#3')
+ expect(wrapper.text()).not.toContain('#3.0')
+ })
+
+ it('formats fractional index 1.5 as #1.5', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard({ ...presentBook, seriesIndex: 1.5, seriesName: 'Dune' })
+ expect(wrapper.text()).toContain('#1.5')
+ })
+
+ it('tooltip content shows series name combined with number', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard(bookWithSeries)
+ const tooltip = wrapper.find('[data-testid="tooltip-content"]')
+ expect(tooltip.exists()).toBe(true)
+ expect(tooltip.text()).toContain('The Expanse #3')
+ })
+
+ it('tooltip shows only number when seriesName is null', () => {
+ cardOverlays.value = ['series-position']
+ const wrapper = mountCard({ ...presentBook, seriesIndex: 5, seriesName: null })
+ const tooltip = wrapper.find('[data-testid="tooltip-content"]')
+ expect(tooltip.exists()).toBe(true)
+ expect(tooltip.text()).toBe('#5')
+ })
+
+ it('lock and series badges coexist in the top-right container', () => {
+ cardOverlays.value = ['series-position', 'lock-status']
+ const wrapper = mountCard({ ...presentBook, seriesIndex: 2, seriesName: 'Dune', hasMetadataLocks: true })
+ expect(wrapper.text()).toContain('#2')
+ expect(wrapper.find('.text-amber-400').exists()).toBe(true)
+ })
+})
diff --git a/client/src/features/settings/AppearanceSettings.vue b/client/src/features/settings/AppearanceSettings.vue
index d0162f4ee..3209e193f 100644
--- a/client/src/features/settings/AppearanceSettings.vue
+++ b/client/src/features/settings/AppearanceSettings.vue
@@ -34,6 +34,7 @@ const OVERLAY_OPTIONS: { key: CardOverlayKey; label: string; hint: string }[] =
{ key: 'format', label: 'File format', hint: 'Color-coded EPUB, PDF, CBZ badge at bottom-right' },
{ key: 'rating', label: 'Rating', hint: 'Star rating indicator at bottom-left' },
{ key: 'read-status', label: 'Read status', hint: 'Color icon showing the current reading status at top-left' },
+ { key: 'series-position', label: 'Series number', hint: 'Badge showing the book position in its series at top-right (e.g. #3, #1.5)' },
{ key: 'lock-status', label: 'Lock status', hint: 'Metadata lock icon at top-right - orange when locked, green when unlocked' },
]
diff --git a/commitlint.config.cjs b/commitlint.config.cjs
index 4f8f374ee..374cdb1d0 100644
--- a/commitlint.config.cjs
+++ b/commitlint.config.cjs
@@ -2,7 +2,7 @@ module.exports = {
extends: ["@commitlint/config-conventional"],
rules: {
"type-enum": [2, "always", ["feat", "fix", "db", "perf", "refactor", "style", "docs", "test", "build", "ci", "chore", "security", "revert"]],
- "header-max-length": [2, "always", 72],
+ "header-max-length": [2, "always", 100],
"subject-full-stop": [2, "never", "."],
"scope-enum": [
2,