@prenta/admin 0.93.0 → 0.94.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @actuate-media/cms-admin
 
+## 0.94.0
+
+### Minor Changes
+
+- 385dd10: Responsive + accessibility layer
+
+  Ports `design-system/cms-responsive.css` from the page-builder design bundle,
+  which the prototype now links and which post-dates the handoff copy in
+  `design_handoff_page_builder/` (followup 7: the bundle in hand had one `:focus`
+  rule, no `:focus-visible`, no reduced-motion, no contrast preference). None of
+  it existed in the admin.
+
+  The prototype's selectors (`.ni`, `.sec-panel`, `.icbtn`) do not exist here —
+  this admin is Tailwind over the same tokens — so the **rules** are ported and
+  re-expressed against the real structure, in one stylesheet scoped throughout to
+  `.prenta-admin`. The admin renders inside consumer applications; an unscoped
+  `@media print` or `:focus-visible` rule would restyle the host's own pages, and
+  a test asserts every selector in the file carries the scope.
+  - **Visible focus everywhere**, as a floor. Base-layer, so any component with
+    its own `focus-visible:ring` still wins and this only fills the gaps.
+  - **A skip link** — the first focusable thing in the admin, so a keyboard user's
+    first Tab offers a jump past ~20 sidebar items.
+  - **`prefers-reduced-motion`** honoured as a media query, not only through the
+    Appearance setting and the `motion-safe:` utilities that were written with it.
+  - **`prefers-contrast: more`** raises the three tertiary tokens, in both themes,
+    and a test asserts it raises rather than lowers — the shipped `--muted` is
+    already an AA correction over the handoff's value, and a "more contrast"
+    preference that moved it the other way would be worse than ignoring it.
+  - **44px touch targets under a coarse pointer**, opt-in per control rather than
+    a blanket `button` rule. The admin is full of dense tables where growing every
+    button reflows the layout around it; the design bundle carries a curated list
+    for the same reason. The switch is the carve-out both hit: its thumb is
+    positioned against the track, so the **hit area** grows and the control paints
+    at its designed 34×19.
+  - **The editor stacks below 900px** — rail above canvas, both full width, drag
+    handle gone. The width override needs `!important`: the rail's width is an
+    inline style because it is drag-resizable and persisted.
+  - **Print** drops the chrome and lets the canvas print at natural size instead
+    of as a clipped, transformed thumbnail.
+
+  Two rules deliberately did not come across. The prototype turns the sidebar into
+  a fixed bottom bar under 768px, where `AdminShell` already has a working
+  slide-in overlay driven by `matchMedia` — replacing a working navigation pattern
+  was not part of finishing the page builder. And the blanket `min-height` list is
+  the per-control class described above.
+
+  Every way this breaks is invisible: a stylesheet that stops being imported, a
+  class hook renamed in a component, or a token override placed before the token
+  it overrides all render perfectly and simply lack the behaviour. Unit tests pin
+  the import order and assert every hook is applied by some component; e2e tests
+  measure the result in a browser, because "the CSS says 44px" and "the button is
+  44px" are different claims. The second caught a real gap — the history button's
+  conditional className had been missed by the edit that added the class to its
+  four neighbours.
+
+- 385dd10: Version history: a mode, not a popup
+
+  The page editor's history was a right-hand dialog with a flat list and a
+  Restore button. The handoff's stage 6 asks for something different in kind:
+  history is about comparing **renders**, so selecting a version puts it on the
+  canvas and marks what changed. A modal covers the thing it exists to let you
+  look at; a drawer resizes it. This overlays the rail instead, so the canvas
+  does not move a pixel and the only thing that differs between two versions is
+  the page itself. An e2e test measures exactly that.
+
+  **The diff is computed, not stored.** Field-level, from the full snapshots the
+  versions API already returns, and the same result drives three surfaces: the
+  per-field list in the panel, the dashed outlines on the canvas, and the review
+  bar's count. One computation, so they cannot disagree. Field names come from
+  the section registry — the same definitions the inspector renders from — so a
+  diff reads in the words the editor typed under, and a custom section type
+  falls back to its raw key rather than dropping the row.
+
+  Whether a field changed is decided **structurally**, and the display summary is
+  used only to render it. Comparing the summaries is the obvious shortcut and it
+  loses real edits: the summary collapses an array to "N items", so retyping a
+  stats row while keeping the row count formats identically on both sides and the
+  field reports no change — no panel row and no canvas outline, on exactly the
+  edit a reviewer opened history to find. Repeaters are descended into row by
+  row, labelled through the registry's own nouns ("Stats · Stat 2 · Value"), so a
+  collapsed summary never has to stand in for a change it cannot express.
+
+  Visibility is diffed alongside content: hiding a section is the one structural
+  change a design-owned CMS gives an editor, and a history that omitted it would
+  be missing the only structural edit there is.
+
+  **Review mode is its own mode, deliberately.** It and site-preview mode both
+  drop the cursor, the hover outline and the section label, which makes one
+  shared suppression rule very tempting — and that rule hides the changed-section
+  label review mode exists to show. They are separate flags, with a test that
+  holds them apart. Editing is frozen throughout: every control that writes reads
+  one flag, so no surface can mutate the current page while the canvas shows a
+  different one.
+
+  **Two things found by testing this against a real browser rather than a mock:**
+  - Restore was nested inside the diff block, so a version with no computed
+    changes — the oldest snapshot held, or a metadata-only save — was reviewable
+    and not restorable. That is backwards: the oldest version is the one a
+    rollback most often wants. The prototype nests it the same way.
+  - Selection and disclosure were separate state, so the review bar's "Back to
+    current" could leave the panel describing one version while the canvas
+    rendered another, with Restore stranded on a row nobody could see. They are
+    the same act and are now one piece of state.
+
+  **And one the review bots found.** The inline site preview is a second editing
+  surface — an iframe of the real site with click-to-edit wired into the same
+  section state — and its handlers checked the user's role and nothing else. The
+  review lock, which every control in the rail honours, stopped at the iframe
+  boundary; so did the read-only lock on Page-Builder-owned pages. Both now read
+  the same single gate. A lock that covers only the rail is not a lock.
+
 ## 0.93.0
 
 ### Minor Changes

package/dist/__tests__/lib/version-diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version-diff.test.d.ts.map

package/dist/__tests__/lib/version-diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-diff.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/version-diff.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/version-diff.test.js

@@ -0,0 +1,230 @@
+import { describe, expect, it } from 'vitest';
+import { changedSectionIds, diffVersions, formatValue, groupChangesBySection, } from '../../lib/version-diff.js';
+function section(overrides) {
+    return {
+        sectionType: 'hero',
+        name: 'Hero Banner',
+        visible: true,
+        content: {},
+        settings: {},
+        ...overrides,
+    };
+}
+describe('formatValue', () => {
+    it('renders absent and blank values as an em dash so an empty diff cell is never blank', () => {
+        expect(formatValue(null)).toBe('—');
+        expect(formatValue(undefined)).toBe('—');
+        expect(formatValue('')).toBe('—');
+        expect(formatValue('   ')).toBe('—');
+        expect(formatValue([])).toBe('—');
+        expect(formatValue({})).toBe('—');
+    });
+    it('summarises structured values rather than dumping them', () => {
+        expect(formatValue([{ value: '1' }, { value: '2' }])).toBe('2 items');
+        expect(formatValue([{ value: '1' }])).toBe('1 item');
+        expect(formatValue({ name: 'hero.jpg', url: '/m/hero.jpg' })).toBe('hero.jpg');
+        // No name-ish key: fall back to a shape description, not "[object Object]".
+        expect(formatValue({ x: 1, y: 2 })).toBe('2 fields');
+    });
+    it('reads booleans and numbers as words the panel can show', () => {
+        expect(formatValue(true)).toBe('Yes');
+        expect(formatValue(false)).toBe('No');
+        expect(formatValue(0)).toBe('0');
+    });
+});
+describe('diffVersions', () => {
+    it('labels content fields through the section registry, not by raw key', () => {
+        const before = [section({ id: 's1', content: { heading: 'Old headline' } })];
+        const after = [section({ id: 's1', content: { heading: 'New headline' } })];
+        const changes = diffVersions(after, before);
+        expect(changes).toEqual([
+            {
+                sectionId: 's1',
+                sectionName: 'Hero Banner',
+                // 'heading' is `label: 'Heading'` on the hero type in the registry.
+                field: 'Heading',
+                from: 'Old headline',
+                to: 'New headline',
+            },
+        ]);
+    });
+    it('falls back to the raw key for a type the registry does not describe', () => {
+        const before = [section({ id: 's1', sectionType: 'opal-pricing', content: { tiers: 'a' } })];
+        const after = [section({ id: 's1', sectionType: 'opal-pricing', content: { tiers: 'b' } })];
+        expect(diffVersions(after, before)[0]?.field).toBe('tiers');
+    });
+    it('reports a field cleared to nothing — the key exists only in the older snapshot', () => {
+        const before = [section({ id: 's1', content: { heading: 'Something' } })];
+        const after = [section({ id: 's1', content: {} })];
+        expect(diffVersions(after, before)).toEqual([
+            { sectionId: 's1', sectionName: 'Hero Banner', field: 'Heading', from: 'Something', to: '—' },
+        ]);
+    });
+    it('reports visibility as a state, because hiding a section is the one structural edit there is', () => {
+        const before = [section({ id: 's1', visible: true })];
+        const after = [section({ id: 's1', visible: false })];
+        expect(diffVersions(after, before)).toEqual([
+            {
+                sectionId: 's1',
+                sectionName: 'Hero Banner',
+                field: 'Visibility',
+                from: 'Shown',
+                to: 'Hidden',
+            },
+        ]);
+    });
+    it('reports added and removed sections', () => {
+        const before = [section({ id: 's1' })];
+        const after = [section({ id: 's1' }), section({ id: 's2', name: 'CTA', sectionType: 'cta' })];
+        expect(diffVersions(after, before)).toEqual([
+            { sectionId: 's2', sectionName: 'CTA', field: 'Section', from: '—', to: 'Added' },
+        ]);
+        expect(diffVersions(before, after)).toEqual([
+            { sectionId: 's2', sectionName: 'CTA', field: 'Section', from: 'Present', to: 'Removed' },
+        ]);
+    });
+    it('reports nothing when the snapshots match', () => {
+        const same = [section({ id: 's1', content: { heading: 'Same' } })];
+        expect(diffVersions(same, [section({ id: 's1', content: { heading: 'Same' } })])).toEqual([]);
+    });
+    it('reports nothing against a missing predecessor', () => {
+        // The oldest version we hold is not the moment the page was created, so
+        // reporting every field as "added" would state something false.
+        expect(diffVersions([section({ id: 's1', content: { heading: 'x' } })], undefined)).toEqual([]);
+        expect(diffVersions([section({ id: 's1' })], null)).toEqual([]);
+    });
+    it('does not report a settings key that was merely absent versus explicitly default', () => {
+        // `{}` and `{ backgroundType: undefined }` format identically, so neither
+        // produces a row. Without this the first save after a schema addition
+        // would light up every section on the canvas.
+        const before = [section({ id: 's1', settings: {} })];
+        const after = [section({ id: 's1', settings: { backgroundType: undefined } })];
+        expect(diffVersions(after, before)).toEqual([]);
+    });
+    it('labels known settings and reports a real background change', () => {
+        const before = [section({ id: 's1', settings: { backgroundType: 'none' } })];
+        const after = [section({ id: 's1', settings: { backgroundType: 'solid' } })];
+        expect(diffVersions(after, before)).toEqual([
+            {
+                sectionId: 's1',
+                sectionName: 'Hero Banner',
+                field: 'Background type',
+                from: 'none',
+                to: 'solid',
+            },
+        ]);
+    });
+});
+describe('diffVersions — structured fields', () => {
+    const stats = (rows) => section({ id: 's1', sectionType: 'stats', name: 'By The Numbers', content: { stats: rows } });
+    it('catches an edit that keeps the row count', () => {
+        // The bug this exists for: deciding "did it change" from the DISPLAY
+        // summary collapses an array to "2 items", so retyping a row while keeping
+        // the count formats identically on both sides and the field reports no
+        // change — no panel row AND no outline on the canvas, which is exactly the
+        // edit a reviewer opened history to find.
+        const before = [
+            stats([
+                { value: '10k', label: 'Users' },
+                { value: '99%', label: 'Uptime' },
+            ]),
+        ];
+        const after = [
+            stats([
+                { value: '20k', label: 'Users' },
+                { value: '99%', label: 'Uptime' },
+            ]),
+        ];
+        const changes = diffVersions(after, before);
+        expect(changes).toHaveLength(1);
+        expect(changes[0]?.from).toBe('10k');
+        expect(changes[0]?.to).toBe('20k');
+        // Named down to the row and the sub-field, so "which one" has an answer.
+        expect(changes[0]?.field).toBe('Stats · Stat 1 · Value');
+        expect(changedSectionIds(changes).has('s1')).toBe(true);
+    });
+    it('never emits a row whose before and after both read as a bare count', () => {
+        const before = [
+            stats([
+                { value: 'a', label: 'x' },
+                { value: 'b', label: 'y' },
+            ]),
+        ];
+        const after = [
+            stats([
+                { value: 'c', label: 'x' },
+                { value: 'd', label: 'y' },
+            ]),
+        ];
+        for (const change of diffVersions(after, before)) {
+            expect(change.from).not.toBe(change.to);
+            expect(change.from).not.toMatch(/^\d+ items?$/);
+        }
+    });
+    it('reports added and removed rows', () => {
+        const before = [stats([{ value: '10k', label: 'Users' }])];
+        const after = [
+            stats([
+                { value: '10k', label: 'Users' },
+                { value: '99%', label: 'Uptime' },
+            ]),
+        ];
+        expect(diffVersions(after, before)).toEqual([
+            expect.objectContaining({ field: 'Stats · Stat 2', from: '—', to: 'Added' }),
+        ]);
+        expect(diffVersions(before, after)).toEqual([
+            expect.objectContaining({ field: 'Stats · Stat 2', from: 'Present', to: 'Removed' }),
+        ]);
+    });
+    it('catches a nested change inside a media object', () => {
+        // Same failure one level down: two media objects with the same `name` used
+        // to format identically while pointing at different files.
+        const media = (url) => ({ name: 'hero.jpg', url });
+        const before = [section({ id: 's1', content: { imageUrl: media('/a.jpg') } })];
+        const after = [section({ id: 's1', content: { imageUrl: media('/b.jpg') } })];
+        expect(diffVersions(after, before)).toHaveLength(1);
+    });
+    it('treats every spelling of blank as unchanged', () => {
+        // Tightening the comparison must not start reporting "— → —".
+        for (const [before, after] of [
+            ['', null],
+            [null, undefined],
+            [undefined, '   '],
+            [[], undefined],
+            [{}, null],
+        ]) {
+            const changes = diffVersions([section({ id: 's1', content: { heading: after } })], [section({ id: 's1', content: { heading: before } })]);
+            expect(changes, `${JSON.stringify(before)} → ${JSON.stringify(after)}`).toEqual([]);
+        }
+    });
+    it('reports an unchanged repeater as no change at all', () => {
+        const rows = [{ value: '10k', label: 'Users' }];
+        expect(diffVersions([stats(rows)], [stats([...rows.map((r) => ({ ...r }))])])).toEqual([]);
+    });
+});
+describe('groupChangesBySection', () => {
+    it('groups by section in first-seen order', () => {
+        const before = [
+            section({ id: 's1', content: { heading: 'a', body: 'a' } }),
+            section({ id: 's2', name: 'CTA', sectionType: 'cta', content: { heading: 'a' } }),
+        ];
+        const after = [
+            section({ id: 's1', content: { heading: 'b', body: 'b' } }),
+            section({ id: 's2', name: 'CTA', sectionType: 'cta', content: { heading: 'b' } }),
+        ];
+        const groups = groupChangesBySection(diffVersions(after, before));
+        expect(groups.map((g) => g.sectionId)).toEqual(['s1', 's2']);
+        expect(groups[0]?.changes).toHaveLength(2);
+        expect(groups[1]?.changes).toHaveLength(1);
+    });
+});
+describe('changedSectionIds', () => {
+    it('collapses several changes on one section to a single outline', () => {
+        const before = [section({ id: 's1', content: { heading: 'a', body: 'a' } })];
+        const after = [section({ id: 's1', content: { heading: 'b', body: 'b' } })];
+        const ids = changedSectionIds(diffVersions(after, before));
+        expect(ids.size).toBe(1);
+        expect(ids.has('s1')).toBe(true);
+    });
+});
+//# sourceMappingURL=version-diff.test.js.map

package/dist/__tests__/lib/version-diff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-diff.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/version-diff.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/lib/version-history.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version-history.test.d.ts.map

package/dist/__tests__/lib/version-history.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-history.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/version-history.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/version-history.test.js

@@ -0,0 +1,125 @@
+import { describe, expect, it } from 'vitest';
+import { dayLabel, groupVersionsByDay, initials, toPageVersion, versionKind, } from '../../lib/version-history.js';
+const NOW = new Date('2026-08-02T17:00:00Z');
+function version(id, createdAt) {
+    return {
+        id,
+        changeType: 'UPDATE',
+        createdAt,
+        author: { id: 'u1', name: 'Sarah Mills' },
+        sections: [],
+    };
+}
+describe('toPageVersion', () => {
+    it('lifts the section snapshot out of the version payload', () => {
+        const mapped = toPageVersion({
+            id: 'v1',
+            changeType: 'PUBLISH',
+            createdAt: '2026-08-02T12:00:00Z',
+            data: {
+                sections: [
+                    { id: 's1', sectionType: 'hero', name: 'Hero', visible: true, content: {}, settings: {} },
+                ],
+            },
+            changedBy: { id: 'u1', name: 'Sarah Mills', email: 's@example.com' },
+        });
+        expect(mapped.sections).toHaveLength(1);
+        expect(mapped.sections[0]?.id).toBe('s1');
+        expect(mapped.changeType).toBe('PUBLISH');
+        expect(mapped.author.name).toBe('Sarah Mills');
+    });
+    it('preserves an unmanaged section rather than dropping it from the snapshot', () => {
+        // Coercing a snapshot more strictly than the live document reads would
+        // make an externally-managed section look deleted in every version.
+        const mapped = toPageVersion({
+            id: 'v1',
+            changeType: 'UPDATE',
+            createdAt: '2026-08-02T12:00:00Z',
+            data: {
+                sections: [
+                    { id: 's1', sectionType: 'opal-pricing', name: 'Pricing', visible: true, content: {} },
+                ],
+            },
+        });
+        expect(mapped.sections).toHaveLength(1);
+        expect(mapped.sections[0]?.sectionType).toBe('opal-pricing');
+    });
+    it('falls back through name → email → a real word for the avatar', () => {
+        expect(toPageVersion({ id: 'v', changeType: 'UPDATE', createdAt: '', data: null }).author.name).toBe('Unknown');
+        expect(toPageVersion({
+            id: 'v',
+            changeType: 'UPDATE',
+            createdAt: '',
+            data: null,
+            changedBy: { id: 'u', name: '  ', email: 'a@b.com' },
+        }).author.name).toBe('a@b.com');
+    });
+    it('yields no sections for a version whose payload has none', () => {
+        expect(toPageVersion({ id: 'v', changeType: 'DELETE', createdAt: '', data: {} }).sections).toEqual([]);
+    });
+});
+describe('versionKind', () => {
+    it('marks a published snapshot as the one a visitor could have seen', () => {
+        expect(versionKind('PUBLISH')).toEqual({ label: 'Published', tone: 'live' });
+    });
+    it('calls UPDATE "Saved", never "Draft"', () => {
+        // Every row written before cms-core started recording PUBLISH is an UPDATE
+        // whether or not it went live, so "Draft" would be false for those.
+        expect(versionKind('UPDATE').label).toBe('Saved');
+    });
+    it('distinguishes a rollback from authored content', () => {
+        expect(versionKind('RESTORE').label).toBe('Restored');
+    });
+    it('degrades to a neutral label for an unrecognised type', () => {
+        expect(versionKind('SOMETHING_NEW').label).toBe('Saved');
+    });
+});
+describe('dayLabel', () => {
+    it('names today and yesterday', () => {
+        expect(dayLabel('2026-08-02T09:00:00', NOW)).toBe('Today');
+        expect(dayLabel('2026-08-01T23:59:00', NOW)).toBe('Yesterday');
+    });
+    it('drops the year within the current one and keeps it outside', () => {
+        expect(dayLabel('2026-07-27T09:00:00', NOW)).not.toMatch(/2026/);
+        expect(dayLabel('2025-07-27T09:00:00', NOW)).toMatch(/2025/);
+    });
+    it('does not throw on an unparseable timestamp', () => {
+        expect(dayLabel('not-a-date', NOW)).toBe('Unknown date');
+    });
+});
+describe('groupVersionsByDay', () => {
+    it('groups consecutive runs and keeps newest-first order', () => {
+        const groups = groupVersionsByDay([
+            version('v5', '2026-08-02T16:12:00'),
+            version('v4', '2026-08-02T11:03:00'),
+            version('v3', '2026-08-01T17:47:00'),
+            version('v1', '2026-07-27T09:30:00'),
+        ], NOW);
+        expect(groups.map((g) => g.label)).toEqual(['Today', 'Yesterday', expect.stringMatching(/Jul/)]);
+        expect(groups[0]?.versions.map((v) => v.id)).toEqual(['v5', 'v4']);
+    });
+    it('does not merge two non-adjacent runs that share a label', () => {
+        // A Map keyed on the label would silently reorder an unsorted page into
+        // something that reads as chronological but is not.
+        const groups = groupVersionsByDay([
+            version('a', '2026-08-02T16:00:00'),
+            version('b', '2026-08-01T16:00:00'),
+            version('c', '2026-08-02T09:00:00'),
+        ], NOW);
+        expect(groups.map((g) => g.label)).toEqual(['Today', 'Yesterday', 'Today']);
+    });
+    it('returns nothing for an empty list', () => {
+        expect(groupVersionsByDay([], NOW)).toEqual([]);
+    });
+});
+describe('initials', () => {
+    it('takes first and last for a full name, two letters for one word', () => {
+        expect(initials('Sarah Mills')).toBe('SM');
+        expect(initials('Sarah Jane Mills')).toBe('SM');
+        expect(initials('sarah')).toBe('SA');
+    });
+    it('never renders an empty monogram', () => {
+        expect(initials('   ')).toBe('?');
+    });
+});
+//# sourceMappingURL=version-history.test.js.map

package/dist/__tests__/lib/version-history.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-history.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/version-history.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/styles/responsive-layer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=responsive-layer.test.d.ts.map

package/dist/__tests__/styles/responsive-layer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-layer.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/styles/responsive-layer.test.ts"],"names":[],"mappings":""}