2025-10-29 22:16:33 -06:00
|
|
|
import React from 'react';
|
2025-12-06 14:49:46 -07:00
|
|
|
import {
|
|
|
|
|
createMockDomain,
|
|
|
|
|
createTestForm,
|
|
|
|
|
render,
|
|
|
|
|
renderInDarkMode,
|
|
|
|
|
renderInLightMode,
|
|
|
|
|
screen
|
|
|
|
|
} from '../../test-utils';
|
2025-10-29 22:16:33 -06:00
|
|
|
import {CollectionEditForm} from './CollectionEditForm';
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
// Mock the TagsContext
|
2025-10-29 22:16:33 -06:00
|
|
|
jest.mock('../../Tags', () => ({
|
|
|
|
|
TagsContext: {
|
|
|
|
|
_currentValue: {
|
|
|
|
|
SingleTag: ({name}) => <span data-testid="applied-tag">{name}</span>
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
}));
|
|
|
|
|
|
|
|
|
|
// Mock Common components
|
|
|
|
|
jest.mock('../Common', () => ({
|
|
|
|
|
...jest.requireActual('../Common'),
|
2025-12-05 18:26:36 -07:00
|
|
|
WROLModeMessage: ({content}) => <div data-testid="wrol-mode-message">{content}</div>,
|
2025-10-29 22:16:33 -06:00
|
|
|
}));
|
|
|
|
|
|
|
|
|
|
describe('CollectionEditForm', () => {
|
|
|
|
|
const mockCollection = createMockDomain();
|
|
|
|
|
|
|
|
|
|
describe('Form Rendering', () => {
|
2025-12-05 18:26:36 -07:00
|
|
|
it('renders children and Save button', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div data-testid="child-content">Form fields here</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByTestId('child-content')).toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
expect(screen.getByRole('button', {name: /save/i})).toBeInTheDocument();
|
|
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('renders title when provided', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} title="Edit Domain: example.com">
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByRole('heading', {level: 1})).toHaveTextContent('Edit Domain: example.com');
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('renders WROL mode message when provided', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
render(
|
|
|
|
|
<CollectionEditForm
|
|
|
|
|
form={form}
|
2025-12-05 18:26:36 -07:00
|
|
|
wrolModeContent="Editing disabled in WROL Mode"
|
|
|
|
|
>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByTestId('wrol-mode-message')).toHaveTextContent('Editing disabled in WROL Mode');
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('renders action buttons when provided', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
render(
|
|
|
|
|
<CollectionEditForm
|
|
|
|
|
form={form}
|
2025-12-05 18:26:36 -07:00
|
|
|
actionButtons={<button data-testid="delete-button">Delete</button>}
|
|
|
|
|
>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByTestId('delete-button')).toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('renders appliedTagName when provided', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} appliedTagName="News">
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByTestId('applied-tag')).toHaveTextContent('News');
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('does not render appliedTagName when not provided', () => {
|
|
|
|
|
const form = createTestForm(mockCollection);
|
2025-10-29 22:16:33 -06:00
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.queryByTestId('applied-tag')).not.toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
describe('Save/Cancel Actions', () => {
|
|
|
|
|
it('shows Cancel button when onCancel provided', () => {
|
|
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
const mockOnCancel = jest.fn();
|
|
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} onCancel={mockOnCancel}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
expect(screen.getByRole('button', {name: /cancel/i})).toBeInTheDocument();
|
|
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('does not show Cancel button when onCancel not provided', () => {
|
|
|
|
|
const form = createTestForm(mockCollection);
|
2025-10-29 22:16:33 -06:00
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.queryByRole('button', {name: /cancel/i})).not.toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('disables Save button when form is disabled', () => {
|
|
|
|
|
const form = createTestForm(mockCollection, {
|
|
|
|
|
overrides: {disabled: true}
|
|
|
|
|
});
|
2025-10-29 22:16:33 -06:00
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByRole('button', {name: /save/i})).toBeDisabled();
|
2025-12-05 17:12:21 -07:00
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('disables Cancel button when form is disabled', () => {
|
|
|
|
|
const form = createTestForm(mockCollection, {
|
|
|
|
|
overrides: {disabled: true}
|
|
|
|
|
});
|
|
|
|
|
const mockOnCancel = jest.fn();
|
2025-12-05 17:12:21 -07:00
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} onCancel={mockOnCancel}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-12-05 17:12:21 -07:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.getByRole('button', {name: /cancel/i})).toBeDisabled();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
2025-12-05 18:26:36 -07:00
|
|
|
});
|
2025-12-02 15:33:46 -07:00
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
describe('Error States', () => {
|
2025-12-02 15:33:46 -07:00
|
|
|
it('displays form-level errors', () => {
|
|
|
|
|
const form = createTestForm(mockCollection, {
|
|
|
|
|
overrides: {error: 'Something went wrong'}
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-12-02 15:33:46 -07:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
expect(screen.getByText(/something went wrong/i)).toBeInTheDocument();
|
|
|
|
|
});
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
it('does not display error message when no error', () => {
|
|
|
|
|
const form = createTestForm(mockCollection);
|
2025-12-02 15:33:46 -07:00
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
render(
|
|
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-12-02 15:33:46 -07:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
expect(screen.queryByText(/error/i)).not.toBeInTheDocument();
|
2025-12-02 15:33:46 -07:00
|
|
|
});
|
2025-12-05 18:26:36 -07:00
|
|
|
});
|
2025-12-02 15:33:46 -07:00
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
describe('Form Submission', () => {
|
|
|
|
|
it('calls form.onSubmit when Save button is clicked', () => {
|
|
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
form.onSubmit = jest.fn();
|
2025-12-02 15:33:46 -07:00
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
render(
|
|
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-12-02 15:33:46 -07:00
|
|
|
);
|
|
|
|
|
|
2025-12-05 18:26:36 -07:00
|
|
|
screen.getByRole('button', {name: /save/i}).click();
|
|
|
|
|
expect(form.onSubmit).toHaveBeenCalled();
|
2025-12-02 15:33:46 -07:00
|
|
|
});
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
|
|
|
|
describe('Theme Integration', () => {
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
// Panel/Header are token-driven (see ui/Surfaces.tsx): their colors come from CSS
|
|
|
|
|
// variables scoped on `[data-theme]`, not from JS branching on the theme. There is
|
|
|
|
|
// no more "inverted" prop/class to assert on -- just that the same markup renders
|
|
|
|
|
// in both modes.
|
|
|
|
|
it('renders a token-driven Panel in dark mode', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
const {container} = renderInDarkMode(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
expect(container.querySelector('.wrolpi-panel')).toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
it('renders a token-driven Panel in light mode', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
const {container} = renderInLightMode(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
expect(container.querySelector('.wrolpi-panel')).toBeInTheDocument();
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
it('renders a token-driven Header for the title', () => {
|
2025-10-29 22:16:33 -06:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
|
|
|
|
|
const {container} = renderInDarkMode(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} title="Test Collection">
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-10-29 22:16:33 -06:00
|
|
|
);
|
|
|
|
|
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
const header = container.querySelector('.wrolpi-header');
|
2025-10-29 22:16:33 -06:00
|
|
|
expect(header).toBeInTheDocument();
|
ui: Common.js and thirteen more files off Semantic
Phase 2, part 3. Baseline 63 -> 50.
Common.js is the one that mattered: 51 files import it, so its Semantic usage
was propping up the rest of the migration. Everything in it now comes from the
library -- Paginator, the two search inputs, DirectorySearch, TabLinks, the
toggles, the messages, APIButton, Breadcrumbs, SimpleAccordion, IframeViewer,
CardPoster, FileIcon, LoadStatistic, the theme menu, and the hotspot icons.
Also migrated: Placeholder, Apps, ArchivePreview, CbzViewer, AddToPlaylist,
TaggedDeleteConfirmModal, the collection edit/tag forms, and four inventory
components.
New in the library, all in the gallery and tested:
SearchBox Semantic's `<Search category>` with its grouped results shape
kept, because four call sites already build it. A real
combobox rather than a div that listens for clicks.
Pagination Semantic's prop names; onPageChange gets the page number.
TabBar the strip only -- routing stays with the caller.
IconStack Semantic's IconGroup, named once for assistive technology.
Table.HeaderCell sorted/onSort -- a real button carrying aria-sort.
Button/IconButton translate Semantic's size names.
That last one is defensive: unmigrated callers still pass size='tiny', and
Mantine drops a size it does not recognise without a word, so the button
quietly renders at the wrong size. Mapping here keeps the mixed state honest.
Three real bugs found and fixed on the way, none of them cosmetic:
* `fileSuffixIconName` returned fourteen icon names the map did not have, so
opening a folder with a PDF, a Word document or an archive in it logged an
error and drew a fallback glyph. All fourteen mapped, with a test that
walks the mapper's own return values, and another asserting every mapped
name resolves to a Tabler component that exists.
* `Statistic` relied on Semantic's `Statistic.Group` for its spacing, so on
the dashboard the load averages ran together into "1 MIN. LOAD5 MIN.
LOAD15 MIN. LOAD". It carries its own spacing now.
* Semantic's inverted stylesheet colors every descendant of an inverted
segment, so Toggle labels inherited #dddddd -- white pixels in night mode,
on the Settings page, which is exactly where someone adjusts their WROLPi
in the dark. Restated from tokens.
The baseline ratchet gained a third assertion: a migrated file may still lean
on Semantic's CSS classes without importing the library, which the import check
cannot see and which would collapse silently when Phase 4 deletes the
stylesheet. There is one such bridge today and it is now declared.
2026-07-30 10:00:48 -06:00
|
|
|
expect(header).toHaveTextContent('Test Collection');
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|
|
|
|
|
});
|
2025-12-02 15:33:46 -07:00
|
|
|
|
|
|
|
|
describe('CSS Classes', () => {
|
ui: a row of buttons is spaced by the row
The archive page's six actions shared edges, and Update sat lower than the
rest. Both come from the same thing: Semantic's Button carried
`margin: 0 .25em .25em 0`, so a page could list buttons as bare siblings and
they arrived spaced -- and separated from the line below when the row wrapped.
Nothing replaced that margin.
Two of those six answered with `marginTop: 0.5em`, which is the wrong axis: a
Button is `display: inline-flex; vertical-align: middle`, and `vertical-align`
is measured on the MARGIN box, so half of any top margin shows up as the
visible button dropping. It was covering the wrapped-row case in the only axis
a margin can, and paying for it in the other one.
`.wrolpi-button-row` is a flex row with a gap, so both axes are covered at once
and no button needs a margin of its own -- the same rule as `.wrolpi-stack`,
along the other axis. Applied to the five rows in the app that had no gap: the
archive page, the shared collection edit form (which three pages hand action
buttons to, and where nine buttons plus Cancel carried `margin-top: 1em` each
while Save carried none), the doc page's two responsive branches, and the
downloads table's edit/restart pair.
`.action-button-spacing` goes with them; it was that same margin, on Cancel.
Guarded four ways. ui-layout.cy.js measures that the row really spaces what it
holds, wraps rather than overflows, centres its buttons against a taller item
beside them, and counts a confirmed APIButton as one item rather than two --
that one returns a fragment holding a `<Confirm/>`, which would open a hole in
the row if it did not portal. Common.test.js scans for the two ways this comes
back: a button in a row stamping a vertical margin, and a row of buttons that is
not a row. Neither throws, which is how the app got here.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 16:39:03 -06:00
|
|
|
it('puts its actions in a button row, and leaves their margins alone', () => {
|
|
|
|
|
/*
|
|
|
|
|
* `action-button-spacing` was `margin-top: 1em` on Cancel alone, matching the same
|
|
|
|
|
* margin the three calling pages stamped on each of their action buttons -- so every
|
|
|
|
|
* button in this row sat 1em below the Save beside it, which has none. The row spaces
|
|
|
|
|
* and wraps them now, and nothing in it carries a margin of its own.
|
|
|
|
|
*/
|
2025-12-02 15:33:46 -07:00
|
|
|
const form = createTestForm(mockCollection);
|
|
|
|
|
const mockOnCancel = jest.fn();
|
|
|
|
|
|
ui: a row of buttons is spaced by the row
The archive page's six actions shared edges, and Update sat lower than the
rest. Both come from the same thing: Semantic's Button carried
`margin: 0 .25em .25em 0`, so a page could list buttons as bare siblings and
they arrived spaced -- and separated from the line below when the row wrapped.
Nothing replaced that margin.
Two of those six answered with `marginTop: 0.5em`, which is the wrong axis: a
Button is `display: inline-flex; vertical-align: middle`, and `vertical-align`
is measured on the MARGIN box, so half of any top margin shows up as the
visible button dropping. It was covering the wrapped-row case in the only axis
a margin can, and paying for it in the other one.
`.wrolpi-button-row` is a flex row with a gap, so both axes are covered at once
and no button needs a margin of its own -- the same rule as `.wrolpi-stack`,
along the other axis. Applied to the five rows in the app that had no gap: the
archive page, the shared collection edit form (which three pages hand action
buttons to, and where nine buttons plus Cancel carried `margin-top: 1em` each
while Save carried none), the doc page's two responsive branches, and the
downloads table's edit/restart pair.
`.action-button-spacing` goes with them; it was that same margin, on Cancel.
Guarded four ways. ui-layout.cy.js measures that the row really spaces what it
holds, wraps rather than overflows, centres its buttons against a taller item
beside them, and counts a confirmed APIButton as one item rather than two --
that one returns a fragment holding a `<Confirm/>`, which would open a hole in
the row if it did not portal. Common.test.js scans for the two ways this comes
back: a button in a row stamping a vertical margin, and a row of buttons that is
not a row. Neither throws, which is how the app got here.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 16:39:03 -06:00
|
|
|
const {container} = render(
|
2025-12-05 18:26:36 -07:00
|
|
|
<CollectionEditForm form={form} onCancel={mockOnCancel}>
|
|
|
|
|
<div>Form content</div>
|
|
|
|
|
</CollectionEditForm>
|
2025-12-02 15:33:46 -07:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
const cancelButton = screen.getByRole('button', {name: /cancel/i});
|
ui: a row of buttons is spaced by the row
The archive page's six actions shared edges, and Update sat lower than the
rest. Both come from the same thing: Semantic's Button carried
`margin: 0 .25em .25em 0`, so a page could list buttons as bare siblings and
they arrived spaced -- and separated from the line below when the row wrapped.
Nothing replaced that margin.
Two of those six answered with `marginTop: 0.5em`, which is the wrong axis: a
Button is `display: inline-flex; vertical-align: middle`, and `vertical-align`
is measured on the MARGIN box, so half of any top margin shows up as the
visible button dropping. It was covering the wrapped-row case in the only axis
a margin can, and paying for it in the other one.
`.wrolpi-button-row` is a flex row with a gap, so both axes are covered at once
and no button needs a margin of its own -- the same rule as `.wrolpi-stack`,
along the other axis. Applied to the five rows in the app that had no gap: the
archive page, the shared collection edit form (which three pages hand action
buttons to, and where nine buttons plus Cancel carried `margin-top: 1em` each
while Save carried none), the doc page's two responsive branches, and the
downloads table's edit/restart pair.
`.action-button-spacing` goes with them; it was that same margin, on Cancel.
Guarded four ways. ui-layout.cy.js measures that the row really spaces what it
holds, wraps rather than overflows, centres its buttons against a taller item
beside them, and counts a confirmed APIButton as one item rather than two --
that one returns a fragment holding a `<Confirm/>`, which would open a hole in
the row if it did not portal. Common.test.js scans for the two ways this comes
back: a button in a row stamping a vertical margin, and a row of buttons that is
not a row. Neither throws, which is how the app got here.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 16:39:03 -06:00
|
|
|
const row = container.querySelector('.wrolpi-button-row');
|
|
|
|
|
expect(row).toBeInTheDocument();
|
|
|
|
|
expect(row).toContainElement(cancelButton);
|
|
|
|
|
expect(row).toContainElement(screen.getByRole('button', {name: /save/i}));
|
|
|
|
|
expect(cancelButton).not.toHaveClass('action-button-spacing');
|
2025-12-02 15:33:46 -07:00
|
|
|
});
|
|
|
|
|
});
|
2025-10-29 22:16:33 -06:00
|
|
|
});
|