@orthacms/workspaces-admin 0.4.2 → 0.5.0

package/dist/lib/application/useDeleteWorkspace/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Permanently deletes a workspace via the gateway. On success it invalidates the
- * workspaces list so the deleted workspace drops out of the grid; the caller
+ * workspaces list so the deleted workspace drops out of the table; the caller
  * navigates away from the (now-gone) shell route.
  *
  * `onSuccess` deliberately does **not** return the `invalidateQueries` promise:

package/dist/lib/application/useDeleteWorkspace/index.js

@@ -3,7 +3,7 @@ import { httpWorkspaceGateway } from '../../infrastructure/httpWorkspaceGateway'
 import { workspacesKey } from '../useWorkspaces';
 /**
  * Permanently deletes a workspace via the gateway. On success it invalidates the
- * workspaces list so the deleted workspace drops out of the grid; the caller
+ * workspaces list so the deleted workspace drops out of the table; the caller
  * navigates away from the (now-gone) shell route.
  *
  * `onSuccess` deliberately does **not** return the `invalidateQueries` promise:

package/dist/lib/domain/slug/index.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.spec.d.ts.map

package/dist/lib/domain/slug/index.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["../../../../src/lib/domain/slug/index.spec.ts"],"names":[],"mappings":""}

package/dist/lib/domain/slug/index.spec.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { Slug } from './index';
+/**
+ * The admin's slug rule. Its whole job is to be **the same rule as the
+ * server's**, so the wizard never offers a slug the API then refuses.
+ *
+ * The source of truth is
+ * `packages/workspaces/server/src/lib/workspace/domain/value-objects/slug.ts`
+ * (`^[a-z0-9-]+$`, 1–120 characters), pinned by its own
+ * `slug.spec.ts`. The admin cannot import the server package — no admin package
+ * depends on a server one, and none may start — so the corpus below is that
+ * spec's, transcribed deliberately. If the server rule ever moves, this spec is
+ * meant to go red rather than let the two drift apart in silence.
+ *
+ * The cases that actually catch drift are the near-misses. `blog_post` is the
+ * one a hand-written client regex most often lets through, because `\w` and most
+ * "slugify" helpers treat the underscore as a word character while the server
+ * does not; and 120 vs. 121 is a boundary an admin-side copy is free to get off
+ * by one, since nothing but this test compares the two numbers.
+ */
+describe('Slug (admin mirror of the server rule) [workspaces:I-11]', () => {
+    it.each([
+        ['lowercase letters', 'marketing'],
+        ['letters, digits and hyphens', 'marketing-01'],
+        ['a single character', 'a'],
+        ['exactly 120 characters', 'a'.repeat(120)]
+    ])('accepts %s', (_label, value) => {
+        expect(Slug.isValid(value)).toBe(true);
+        expect(Slug.create(value).value).toBe(value);
+    });
+    it.each([
+        ['empty', ''],
+        ['uppercase', 'Marketing'],
+        ['spaces', 'my workspace'],
+        ['punctuation', 'oops!'],
+        ['underscore', 'blog_post'],
+        ['121 characters', 'a'.repeat(121)]
+    ])('rejects a %s slug', (_label, value) => {
+        expect(Slug.isValid(value)).toBe(false);
+        expect(() => Slug.create(value)).toThrow(/Invalid workspace slug/);
+    });
+    // `isValid` is the field's live feedback and `create` is the last guard
+    // before the request; they have to be one decision, not two that agree
+    // today. The corpus above already asserts both for every case — this states
+    // the relationship the two methods hold by construction.
+    it('guards the request with the same answer the field showed', () => {
+        expect(() => Slug.create('marketing-01')).not.toThrow();
+        expect(() => Slug.create('blog_post')).toThrow();
+    });
+});

package/dist/lib/presentation/components/WorkspaceMembersSettings/MemberListRow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/presentation/components/WorkspaceMembersSettings/MemberListRow/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAU1E,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,QAAQ,EACX,EAAE,kBAAkB,+BAqCpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/presentation/components/WorkspaceMembersSettings/MemberListRow/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAU1E,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,QAAQ,EACX,EAAE,kBAAkB,+BAwCpB"}

package/dist/lib/presentation/components/WorkspaceMembersSettings/MemberListRow/index.js

@@ -16,7 +16,7 @@ const messages = defineMessages({
  */
 export function MemberListRow({ member, canRemove, onRemove }) {
     const intl = useIntl();
-    return (_jsxs("div", { className: "flex items-center gap-3 px-3 py-2", children: [_jsx(WorkspaceAvatar, { className: "size-9 text-xs", initials: member.initials || '—', color: member.color }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsx("span", { className: "truncate text-sm font-medium", children: member.name }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: member.email })] }), canRemove ? (_jsx(Button, { type: "button", variant: "ghost", size: "icon", "data-remove-member": "", onClick: onRemove, "aria-label": intl.formatMessage(messages.remove, {
+    return (_jsxs("div", { className: "flex items-center gap-3 px-3 py-2", children: [_jsx(WorkspaceAvatar, { className: "size-9 text-xs", initials: member.initials || '—', color: member.color }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsx("span", { className: "truncate text-sm font-medium", children: member.name }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: member.email })] }), canRemove ? (_jsx(Button, { type: "button", variant: "ghost", size: "icon", "data-remove-member": "", "data-member-id": member.id, onClick: onRemove, "aria-label": intl.formatMessage(messages.remove, {
                     name: member.name
                 }), children: _jsx(X, { className: "size-4" }) })) : null] }));
 }

package/dist/lib/presentation/components/WorkspaceMembersSettings/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/presentation/components/WorkspaceMembersSettings/index.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,SAAS,EAEZ,MAAM,iCAAiC,CAAC;AAwDzC,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG;IACxC,+CAA+C;IAC/C,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,EACrC,SAAS,EACT,SAAS,EACZ,EAAE,6BAA6B,+BAqI/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/presentation/components/WorkspaceMembersSettings/index.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,SAAS,EAEZ,MAAM,iCAAiC,CAAC;AA8DzC,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG;IACxC,+CAA+C;IAC/C,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,EACrC,SAAS,EACT,SAAS,EACZ,EAAE,6BAA6B,+BA0K/B"}

package/dist/lib/presentation/components/WorkspaceMembersSettings/index.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
 import { defineMessages, useIntl } from 'react-intl';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle, ConfirmDialog, Separator, toast } from '@orthacms/design-system';
+import { isConflict } from '../../../infrastructure/isConflict';
 import { useAddWorkspaceMember } from '../../../application/useAddWorkspaceMember';
 import { useRemoveWorkspaceMember } from '../../../application/useRemoveWorkspaceMember';
 import { MemberDirectorySearch } from './MemberDirectorySearch';
@@ -39,6 +40,10 @@ const messages = defineMessages({
         id: 'workspaces.settings.members.removeError',
         defaultMessage: 'Couldn’t remove that member. Please try again.'
     },
+    lastMember: {
+        id: 'workspaces.settings.members.lastMember',
+        defaultMessage: 'A workspace needs at least one member. Add someone else first, or delete the workspace.'
+    },
     confirmTitle: {
         id: 'workspaces.settings.members.confirmTitle',
         defaultMessage: 'Remove member?'
@@ -67,6 +72,8 @@ export function WorkspaceMembersSettings({ workspace, canUpdate }) {
     const rosterLabelRef = useRef(null);
     // Index whose Remove button focus should land on once the roster re-renders.
     const focusAfterRemoval = useRef(null);
+    // Which row opened the confirm dialog, so a dismissal can hand focus back.
+    const dismissedId = useRef(null);
     // Radix restores focus to the dialog's trigger on close — but the mutation
     // has just unmounted that trigger along with its row, so focus fell to
     // <body> and a keyboard user was dropped at the top of the document. Land on
@@ -109,8 +116,16 @@ export function WorkspaceMembersSettings({ workspace, canUpdate }) {
             focusAfterRemoval.current = Math.max(0, removedIndex);
             toast.success(intl.formatMessage(messages.removed, { name: member.name }));
         }
-        catch {
-            toast.error(intl.formatMessage(messages.removeError));
+        catch (error) {
+            // The server answers 409 `LastMemberError` for the one member who
+            // cannot go — a workspace with nobody in it is unreachable, so the
+            // rule is absolute. "Please try again" is the one thing that will
+            // never work here, and it is what every caller got: the catch was
+            // blind to the status. Both sibling dialogs in this package already
+            // narrow the same 409 (content revoke, workspace delete).
+            (isConflict(error) ? toast.warning : toast.error)(intl.formatMessage(isConflict(error)
+                ? messages.lastMember
+                : messages.removeError));
         }
         finally {
             setPendingRemoval(null);
@@ -118,10 +133,31 @@ export function WorkspaceMembersSettings({ workspace, canUpdate }) {
     };
     return (_jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { asChild: true, children: _jsx("h2", { children: intl.formatMessage(messages.title) }) }), _jsx(CardDescription, { children: intl.formatMessage(messages.description) })] }), _jsxs(CardContent, { className: "flex flex-col gap-4", children: [canUpdate ? (_jsx(MemberDirectorySearch, { excludeIds: excludeIds, onSelect: onSelect, busy: addMember.isPending })) : (_jsx("p", { className: "text-sm text-muted-foreground", children: intl.formatMessage(messages.readOnly) })), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("span", { ref: rosterLabelRef, tabIndex: -1, className: "text-sm font-medium focus-visible:outline-none", children: intl.formatMessage(messages.rosterLabel, {
                                     count: workspace.members.length
-                                }) }), _jsx("ul", { ref: rosterRef, className: "rounded-xl border", children: workspace.members.map((member, index) => (_jsxs("li", { children: [index > 0 ? _jsx(Separator, {}) : null, _jsx(MemberListRow, { member: member, canRemove: canUpdate, onRemove: () => setPendingRemoval(member) })] }, member.id))) })] })] }), _jsx(ConfirmDialog, { open: pendingRemoval !== null, onOpenChange: (open) => {
+                                }) }), _jsx("ul", { ref: rosterRef, className: "rounded-xl border", children: workspace.members.map((member, index) => (_jsxs("li", { children: [index > 0 ? _jsx(Separator, {}) : null, _jsx(MemberListRow, { member: member, canRemove: canUpdate, onRemove: () => {
+                                                dismissedId.current = member.id;
+                                                setPendingRemoval(member);
+                                            } })] }, member.id))) })] })] }), _jsx(ConfirmDialog, { open: pendingRemoval !== null, onOpenChange: (open) => {
                     if (!open)
                         setPendingRemoval(null);
                 }, title: intl.formatMessage(messages.confirmTitle), description: intl.formatMessage(messages.confirmBody, {
                     name: pendingRemoval?.name ?? ''
-                }), confirmLabel: intl.formatMessage(messages.confirmAction), confirmVariant: "destructive", busy: removeMember.isPending, onConfirm: confirmRemoval })] }));
+                }), confirmLabel: intl.formatMessage(messages.confirmAction), confirmVariant: "destructive", busy: removeMember.isPending, onConfirm: confirmRemoval, onCloseAutoFocus: (event) => {
+                    // Radix hands focus back to the `DialogTrigger` it holds in
+                    // context — and this dialog has none, because it is opened
+                    // from state rather than wrapped around a trigger. Its
+                    // default therefore focuses nothing and a keyboard user is
+                    // dropped on <body>, at the top of the document (WCAG
+                    // 2.4.3). Aim at the row that opened it.
+                    //
+                    // Only on a dismissal: after a successful removal that row
+                    // is gone, and the effect above has already claimed the
+                    // slot that replaced it.
+                    if (focusAfterRemoval.current !== null)
+                        return;
+                    const button = rosterRef.current?.querySelector(`[data-remove-member][data-member-id="${dismissedId.current}"]`);
+                    if (!button)
+                        return;
+                    event.preventDefault();
+                    button.focus();
+                } })] }));
 }

package/dist/lib/presentation/components/WorkspacesEmpty/index.d.ts

@@ -9,7 +9,7 @@ type WorkspacesEmptyProps = {
     onCreate: () => void;
 };
 /**
- * The empty state for the grid. When filters are active it offers to clear
+ * The empty state for the table. When filters are active it offers to clear
  * them; otherwise it invites creating the first workspace — but only when the
  * user holds `workspaces:create`.
  */

package/dist/lib/presentation/components/WorkspacesEmpty/index.js

@@ -30,7 +30,7 @@ const messages = defineMessages({
     }
 });
 /**
- * The empty state for the grid. When filters are active it offers to clear
+ * The empty state for the table. When filters are active it offers to clear
  * them; otherwise it invites creating the first workspace — but only when the
  * user holds `workspaces:create`.
  */

package/dist/lib/presentation/components/WorkspacesNavSection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/presentation/components/WorkspacesNavSection/index.tsx"],"names":[],"mappings":"AA8DA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,uCA6FnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/presentation/components/WorkspacesNavSection/index.tsx"],"names":[],"mappings":"AAkEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,uCA2HnC"}

package/dist/lib/presentation/components/WorkspacesNavSection/index.js

@@ -18,6 +18,10 @@ const messages = defineMessages({
     newWorkspace: {
         id: 'workspaces.sidebar.newWorkspace',
         defaultMessage: 'New workspace'
+    },
+    unavailable: {
+        id: 'workspaces.sidebar.unavailable',
+        defaultMessage: 'Couldn’t load your workspaces.'
     }
 });
 /** One workspace row: a link to the workspace, active on any of its sub-paths. */
@@ -40,17 +44,27 @@ function WorkspaceNavRow({ workspace }) {
  */
 export function WorkspacesNavSection() {
     const intl = useIntl();
-    const { data: workspaces } = useWorkspaces();
+    const { data: workspaces, isError } = useWorkspaces();
     const canCreate = useHasPermission(WORKSPACES_CREATE);
     const active = (workspaces ?? []).filter(isActiveWorkspace);
+    const heading = intl.formatMessage(messages.heading);
+    const newWorkspace = intl.formatMessage(messages.newWorkspace);
+    const createAction = canCreate ? (_jsx(SidebarGroupAction, { asChild: true, title: newWorkspace, children: _jsx(Link, { to: "/workspaces/new", "aria-label": newWorkspace, children: _jsx(Plus, {}) }) })) : null;
+    // A failed read must not read as an empty membership. On error `data` is
+    // undefined, so every branch below would render exactly what someone who
+    // genuinely belongs to no workspace sees — the section vanishing, or a bare
+    // heading — and the person is told they have no workspaces when in fact we
+    // could not find out. Every other surface reading this query already says
+    // so (the page, the home panel, the stats strip, the workspace shell); this
+    // one is a nav aid, so it says it in one quiet line rather than an alert.
+    if (isError) {
+        return (_jsxs(SidebarGroup, { children: [_jsx(SidebarGroupLabel, { children: heading }), createAction, _jsx(SidebarGroupContent, { children: _jsx("p", { className: "px-2 text-xs text-sidebar-foreground", children: intl.formatMessage(messages.unavailable) }) })] }));
+    }
     // Nothing to show and nothing to do → skip the section entirely. With create
     // permission we still show it (the "+" invites creating the first one).
     if (active.length === 0 && !canCreate) {
         return null;
     }
-    const heading = intl.formatMessage(messages.heading);
-    const newWorkspace = intl.formatMessage(messages.newWorkspace);
-    const createAction = canCreate ? (_jsx(SidebarGroupAction, { asChild: true, title: newWorkspace, children: _jsx(Link, { to: "/workspaces/new", "aria-label": newWorkspace, children: _jsx(Plus, {}) }) })) : null;
     // Nothing to reveal (create permission but no workspaces yet, and every
     // moment the list query is still in flight) → a plain heading, no
     // Collapsible at all. Two reasons, and the second is the load-bearing one:

package/dist/lib/presentation/pages/WorkspacesPage/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * The Workspaces management page: a searchable, status-filterable grid of
- * workspace cards with a create flow. Rendered at `/workspaces` inside the
+ * The Workspaces management page: a searchable, status-filterable **table** of
+ * workspaces with a create flow. Rendered at `/workspaces` inside the
  * authenticated shell.
  */
 export declare function WorkspacesPage(): import("react").JSX.Element;

package/dist/lib/presentation/pages/WorkspacesPage/index.js

@@ -53,8 +53,8 @@ function matchesSearch(workspace, query) {
         workspace.description.toLowerCase().includes(needle));
 }
 /**
- * The Workspaces management page: a searchable, status-filterable grid of
- * workspace cards with a create flow. Rendered at `/workspaces` inside the
+ * The Workspaces management page: a searchable, status-filterable **table** of
+ * workspaces with a create flow. Rendered at `/workspaces` inside the
  * authenticated shell.
  */
 export function WorkspacesPage() {
@@ -80,7 +80,7 @@ export function WorkspacesPage() {
     // `Active`) so it reveals every workspace — including archived ones the
     // default view hides — matching the empty-state's "see them all" copy. This
     // also unsticks the all-archived case, where resetting to `Active` would
-    // leave the grid empty and the clear button a no-op.
+    // leave the table empty and the clear button a no-op.
     const clearFilters = () => {
         setSearch('');
         setStatus('All');

package/dist/lib/presentation/workspacesPlugin/index.d.ts

@@ -5,16 +5,23 @@ import type { AdminPlugin } from '@orthacms/bootstrap-admin';
  */
 export type WorkspacesAdminPlugin = AdminPlugin;
 /**
- * Creates the admin-side workspaces plugin. It owns two things:
+ * Creates the admin-side workspaces plugin. It owns two areas and fills six
+ * slots.
  *
  * 1. **The workspaces management area** — the private `/workspaces` list and
- *    `/workspaces/new` create wizard, plus the `Layers` toolbar nav entry
- *    contributed to the shell's {@link NAVBAR_START_SLOT} at `order: 20`.
+ *    `/workspaces/new` create wizard, plus the `Layers` entry contributed to
+ *    {@link SIDEBAR_NAV_SLOT} at `order: 10`.
  * 2. **The workspace shell** — the `/workspaces/:id/*` layout (left rail +
- *    switcher) that opens when a workspace card is clicked. The plugin owns the
- *    rail slots; feature plugins (Content/Media/Insights) contribute their rail
- *    buttons + routes there. Workspaces itself contributes the last-section
- *    **Settings** entry + its `/workspaces/:id/settings` page.
+ *    switcher) that opens when a workspace row is clicked. The plugin owns the
+ *    rail slots ({@link WORKSPACE_NAV_SLOT}, {@link WORKSPACE_ROUTE_SLOT});
+ *    feature plugins (Content/Media/Insights) contribute their rail buttons +
+ *    routes there. Workspaces itself contributes the last-section **Settings**
+ *    entry + its `/workspaces/:id/settings` page.
+ *
+ * It also reaches two surfaces outside those areas: the workspace quick-list
+ * and switcher in {@link SIDEBAR_SECTION_SLOT}, and the command palette's
+ * workspace results in {@link COMMAND_SLOT}, plus the home tiles and panel in
+ * {@link HOME_SECTION_SLOT}.
  *
  * @example
  * ```typescript

package/dist/lib/presentation/workspacesPlugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/presentation/workspacesPlugin/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAiD7D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAyHxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/presentation/workspacesPlugin/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAiD7D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAyHxD"}

package/dist/lib/presentation/workspacesPlugin/index.js

@@ -23,16 +23,23 @@ const WorkspaceSettingsPage = lazy(() => import('../pages/WorkspaceSettingsPage'
     default: module.WorkspaceSettingsPage
 })));
 /**
- * Creates the admin-side workspaces plugin. It owns two things:
+ * Creates the admin-side workspaces plugin. It owns two areas and fills six
+ * slots.
  *
  * 1. **The workspaces management area** — the private `/workspaces` list and
- *    `/workspaces/new` create wizard, plus the `Layers` toolbar nav entry
- *    contributed to the shell's {@link NAVBAR_START_SLOT} at `order: 20`.
+ *    `/workspaces/new` create wizard, plus the `Layers` entry contributed to
+ *    {@link SIDEBAR_NAV_SLOT} at `order: 10`.
  * 2. **The workspace shell** — the `/workspaces/:id/*` layout (left rail +
- *    switcher) that opens when a workspace card is clicked. The plugin owns the
- *    rail slots; feature plugins (Content/Media/Insights) contribute their rail
- *    buttons + routes there. Workspaces itself contributes the last-section
- *    **Settings** entry + its `/workspaces/:id/settings` page.
+ *    switcher) that opens when a workspace row is clicked. The plugin owns the
+ *    rail slots ({@link WORKSPACE_NAV_SLOT}, {@link WORKSPACE_ROUTE_SLOT});
+ *    feature plugins (Content/Media/Insights) contribute their rail buttons +
+ *    routes there. Workspaces itself contributes the last-section **Settings**
+ *    entry + its `/workspaces/:id/settings` page.
+ *
+ * It also reaches two surfaces outside those areas: the workspace quick-list
+ * and switcher in {@link SIDEBAR_SECTION_SLOT}, and the command palette's
+ * workspace results in {@link COMMAND_SLOT}, plus the home tiles and panel in
+ * {@link HOME_SECTION_SLOT}.
  *
  * @example
  * ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@orthacms/workspaces-admin",
-    "version": "0.4.2",
+    "version": "0.5.0",
     "description": "@orthacms/workspaces-admin — part of Ortha CMS.",
     "license": "MIT",
     "homepage": "https://github.com/ortha-source/ortha-cms/tree/main/packages/workspaces/admin",
@@ -25,11 +25,11 @@
         "dist"
     ],
     "dependencies": {
-        "@orthacms/bootstrap-admin": "^0.4.2",
-        "@orthacms/design-system": "^0.4.2",
-        "@orthacms/identity-admin": "^0.4.2",
-        "@orthacms/shell-admin": "^0.4.2",
-        "@orthacms/utils-admin": "^0.4.2",
+        "@orthacms/bootstrap-admin": "^0.5.0",
+        "@orthacms/design-system": "^0.5.0",
+        "@orthacms/identity-admin": "^0.5.0",
+        "@orthacms/shell-admin": "^0.5.0",
+        "@orthacms/utils-admin": "^0.5.0",
         "@tanstack/react-form": "^1.0.0",
         "@tanstack/react-query": "^5.0.0",
         "lucide-react": "^1.17.0",

package/dist/lib/api/useAddWorkspaceContent/index.d.ts

@@ -1,15 +0,0 @@
-import type { Workspace } from '../../types/workspace';
-/** Grants a workspace access to one content type. */
-export type AddWorkspaceContentInput = {
-    /** The workspace to grant. */
-    workspaceId: string;
-    /** The content-type slug to grant. */
-    slug: string;
-};
-/**
- * Grants a workspace access to a content type (idempotent server-side).
- * Invalidates the workspaces list so the granted slug shows in settings and the
- * Content Library scopes to it.
- */
-export declare function useAddWorkspaceContent(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, AddWorkspaceContentInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useAddWorkspaceContent/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useAddWorkspaceContent/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,qDAAqD;AACrD,MAAM,MAAM,wBAAwB,GAAG;IACnC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAkBF;;;;GAIG;AACH,wBAAgB,sBAAsB,2GAQrC"}

package/dist/lib/api/useAddWorkspaceMember/index.d.ts

@@ -1,14 +0,0 @@
-import type { Workspace } from '../../types/workspace';
-/** Links an existing directory user to a workspace. */
-export type AddWorkspaceMemberInput = {
-    /** The workspace to add the member to. */
-    workspaceId: string;
-    /** The directory user id to link. */
-    userId: string;
-};
-/**
- * Adds an existing user to a workspace (idempotent server-side). Invalidates the
- * workspaces list so the member appears in the settings roster.
- */
-export declare function useAddWorkspaceMember(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, AddWorkspaceMemberInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useAddWorkspaceMember/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useAddWorkspaceMember/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,uDAAuD;AACvD,MAAM,MAAM,uBAAuB,GAAG;IAClC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAkBF;;;GAGG;AACH,wBAAgB,qBAAqB,0GAQpC"}

package/dist/lib/api/useContentTypes/index.d.ts

@@ -1,10 +0,0 @@
-import type { ContentType } from '../../types/wizard';
-/** Query key for the content-types list. */
-export declare const contentTypesKey: readonly ["content-types"];
-/**
- * Loads every content type so the content step can split them into collections
- * and pages. Returns the standard TanStack Query result; callers read `data`,
- * `isPending`, and `isError`.
- */
-export declare function useContentTypes(): import("@tanstack/react-query").UseQueryResult<NoInfer<ContentType[]>, Error>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useContentTypes/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useContentTypes/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,eAAe,4BAA6B,CAAC;AAY1D;;;;GAIG;AACH,wBAAgB,eAAe,kFAM9B"}

package/dist/lib/api/useCreateWorkspace/index.d.ts

@@ -1,20 +0,0 @@
-import type { Workspace, WorkspaceMember } from '../../types/workspace';
-import type { CreateWorkspaceBody } from '../../types/wizard';
-/**
- * Arguments to the create mutation: the API request body plus the creator. The
- * server derives the owner from the session and ignores `creator`; it's kept
- * only so the optimistic update can seed a card before the response lands.
- */
-export type CreateWorkspaceArgs = {
-    body: CreateWorkspaceBody;
-    creator: WorkspaceMember;
-};
-/**
- * Creates a workspace and optimistically inserts it at the top of the list, so
- * the new card appears the instant the form is submitted. Rolls back on error
- * and reconciles with the server result on settle.
- */
-export declare function useCreateWorkspace(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, CreateWorkspaceArgs, {
-    previous: Workspace[] | undefined;
-}>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useCreateWorkspace/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useCreateWorkspace/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAO9D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;CAC5B,CAAC;AAiBF;;;;GAIG;AACH,wBAAgB,kBAAkB;;GAuCjC"}

package/dist/lib/api/useDeleteWorkspace/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Permanently deletes a workspace. On success it invalidates the workspaces
- * list so the deleted workspace drops out of the grid; the caller navigates away
- * from the (now-gone) shell route.
- *
- * `onSuccess` deliberately does **not** return the `invalidateQueries` promise:
- * awaiting it would delay `mutateAsync` until the list refetches without this
- * workspace, so the shell would re-render and flash its "workspace not found"
- * state before the caller's `navigate('/workspaces')` runs. Firing the
- * invalidation without awaiting lets the caller redirect first.
- */
-export declare function useDeleteWorkspace(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useDeleteWorkspace/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useDeleteWorkspace/index.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,oFASjC"}

package/dist/lib/api/useRemoveWorkspaceContent/index.d.ts

@@ -1,15 +0,0 @@
-import type { Workspace } from '../../types/workspace';
-/** Revokes a workspace's access to one content type. */
-export type RemoveWorkspaceContentInput = {
-    /** The workspace to revoke from. */
-    workspaceId: string;
-    /** The content-type slug to revoke. */
-    slug: string;
-};
-/**
- * Revokes a workspace's access to a content type — only when it's empty
- * (a `409` otherwise, surfaced via the thrown {@link ApiError}). Invalidates the
- * workspaces list on success.
- */
-export declare function useRemoveWorkspaceContent(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, RemoveWorkspaceContentInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useRemoveWorkspaceContent/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useRemoveWorkspaceContent/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,wDAAwD;AACxD,MAAM,MAAM,2BAA2B,GAAG;IACtC,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAqBF;;;;GAIG;AACH,wBAAgB,yBAAyB,8GAQxC"}

package/dist/lib/api/useRemoveWorkspaceMember/index.d.ts

@@ -1,13 +0,0 @@
-/** Removes a member's link to a workspace. */
-export type RemoveWorkspaceMemberInput = {
-    /** The workspace to remove the member from. */
-    workspaceId: string;
-    /** The member's user id. */
-    userId: string;
-};
-/**
- * Removes a member from a workspace (a no-op server-side if they weren't one).
- * Invalidates the workspaces list so the roster updates.
- */
-export declare function useRemoveWorkspaceMember(): import("@tanstack/react-query").UseMutationResult<void, Error, RemoveWorkspaceMemberInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useRemoveWorkspaceMember/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useRemoveWorkspaceMember/index.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,MAAM,MAAM,0BAA0B,GAAG;IACrC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAgBF;;;GAGG;AACH,wBAAgB,wBAAwB,wGAQvC"}

package/dist/lib/api/useSetWorkspaceStatus/index.d.ts

@@ -1,14 +0,0 @@
-import type { Workspace, WorkspaceStatus } from '../../types/workspace';
-/** The target lifecycle status for a workspace. */
-export type SetWorkspaceStatusInput = {
-    /** The workspace to archive/unarchive. */
-    id: string;
-    /** The desired status. */
-    status: WorkspaceStatus;
-};
-/**
- * Flips a workspace between active and archived. Invalidates the workspaces list
- * on success so the shell and grid reflect the new status.
- */
-export declare function useSetWorkspaceStatus(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, SetWorkspaceStatusInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useSetWorkspaceStatus/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useSetWorkspaceStatus/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxE,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG;IAClC,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,MAAM,EAAE,eAAe,CAAC;CAC3B,CAAC;AAqBF;;;GAGG;AACH,wBAAgB,qBAAqB,0GAQpC"}

package/dist/lib/api/useSlugAvailability/index.d.ts

@@ -1,10 +0,0 @@
-import { SlugStatus } from '../../types/wizard';
-/**
- * Live slug-availability check. Debounces input (300ms), then resolves to
- * {@link SlugStatus.Available} / {@link SlugStatus.Taken}. Returns
- * {@link SlugStatus.Empty} for blank input, {@link SlugStatus.Invalid} when the
- * value breaks the `^[a-z0-9-]+$` pattern, and {@link SlugStatus.Checking} while
- * debouncing or fetching.
- */
-export declare function useSlugAvailability(slug: string): SlugStatus;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useSlugAvailability/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useSlugAvailability/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBhD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAe5D"}

package/dist/lib/api/useUpdateWorkspace/index.d.ts

@@ -1,23 +0,0 @@
-import type { AvatarColor } from '@ortha-cms/design-system';
-import type { Workspace } from '../../types/workspace';
-/**
- * A partial profile edit: the target workspace id plus any of the editable
- * fields. Only the fields present are sent; the server writes just those.
- */
-export type UpdateWorkspaceInput = {
-    /** The workspace to edit. */
-    id: string;
-    /** New display name. */
-    name?: string;
-    /** New description (an empty string clears it). */
-    description?: string;
-    /** New accent color. */
-    color?: AvatarColor;
-};
-/**
- * Edits a workspace's name / description / color. On success it invalidates the
- * workspaces list so the shell (which reads the open workspace from that list)
- * re-resolves with the new values.
- */
-export declare function useUpdateWorkspace(): import("@tanstack/react-query").UseMutationResult<Workspace, Error, UpdateWorkspaceInput, unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useUpdateWorkspace/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useUpdateWorkspace/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAkBF;;;;GAIG;AACH,wBAAgB,kBAAkB,uGAQjC"}

package/dist/lib/api/useUsersSearch/index.d.ts

@@ -1,17 +0,0 @@
-import type { DirectoryUser } from '../../types/wizard';
-/** Result of {@link useUsersSearch}. */
-export type UsersSearchResult = {
-    /** Matching directory users (empty until a debounced query resolves). */
-    users: DirectoryUser[];
-    /** Whether a search is currently in flight. */
-    loading: boolean;
-    /** Whether the underlying search query failed. */
-    isError: boolean;
-};
-/**
- * Searches the user directory for the member typeahead. Debounces the query
- * (250ms) so each keystroke doesn't fire a request, and only runs once at least
- * one character has been typed.
- */
-export declare function useUsersSearch(query: string): UsersSearchResult;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/useUsersSearch/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/useUsersSearch/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,yEAAyE;IACzE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AA0CF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAgB/D"}