@estiva-app/ui 0.76.0 → 0.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@estiva-app/ui",
3
- "version": "0.76.0",
3
+ "version": "0.77.0",
4
4
  "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/registry.json CHANGED
@@ -4,9 +4,9 @@
4
4
  "kind": "package",
5
5
  "repo": "estiva-ui",
6
6
  "package": "@estiva-app/ui",
7
- "packageVersion": "0.76.0",
8
- "exports": 202,
9
- "typeExports": 195,
7
+ "packageVersion": "0.77.0",
8
+ "exports": 203,
9
+ "typeExports": 197,
10
10
  "files": null
11
11
  },
12
12
  "storybook": {
@@ -2959,7 +2959,7 @@
2959
2959
  },
2960
2960
  {
2961
2961
  "name": "action",
2962
- "takes": "a handler",
2962
+ "takes": "ButtonAction",
2963
2963
  "required": false,
2964
2964
  "note": "The one thing to do about it — \"New topic\", \"Try again\" — drawn 16px under the line as the package's Button, outlined (Katerina, 2026-09-18)."
2965
2965
  },
@@ -3016,6 +3016,62 @@
3016
3016
  "text-menu signal:font-mono signal:text-small signal:tracking-wider leaf:font-mono leaf:text-small leaf:tracking-wider"
3017
3017
  ]
3018
3018
  },
3019
+ {
3020
+ "name": "EntryShell",
3021
+ "repo": "estiva-ui",
3022
+ "kind": "component",
3023
+ "importPath": "@estiva-app/ui",
3024
+ "sourceFile": "src/EntryShell.tsx",
3025
+ "purpose": "What an app shows while nobody is signed in to it: its logo, one line saying why, and at most one button.",
3026
+ "purposeFrom": "page",
3027
+ "props": [
3028
+ {
3029
+ "name": "logo",
3030
+ "takes": "anything",
3031
+ "required": true,
3032
+ "note": "The app's own mark, drawn at the top in every state, as given: the app sizes it."
3033
+ },
3034
+ {
3035
+ "name": "busy",
3036
+ "takes": "true/false",
3037
+ "required": false,
3038
+ "note": "Entry is still being decided: the logo alone, faded in after 150ms (as a Skeleton is), so an entry that resolves at once flashes nothing."
3039
+ },
3040
+ {
3041
+ "name": "busyLabel",
3042
+ "takes": "text",
3043
+ "required": false,
3044
+ "note": "What a screen reader hears while `busy`; nothing is drawn for it."
3045
+ },
3046
+ {
3047
+ "name": "message",
3048
+ "takes": "anything",
3049
+ "required": false,
3050
+ "note": "The one line saying why nobody is signed in, announced politely when it appears."
3051
+ },
3052
+ {
3053
+ "name": "action",
3054
+ "takes": "ButtonAction & { disabled?: boolean }",
3055
+ "required": false,
3056
+ "note": "The one thing to do about it, drawn under the line (or alone, with no `message`) as the package's primary Button."
3057
+ },
3058
+ {
3059
+ "name": "className",
3060
+ "takes": "text",
3061
+ "required": false,
3062
+ "note": null
3063
+ }
3064
+ ],
3065
+ "variants": [],
3066
+ "ownsBehaviours": [],
3067
+ "status": "stable",
3068
+ "migrationStage": null,
3069
+ "docsId": "frame-entryshell--docs",
3070
+ "storyId": "frame-entryshell--message-with-action",
3071
+ "docPage": "src/EntryShell.mdx",
3072
+ "app": null,
3073
+ "looks": []
3074
+ },
3019
3075
  {
3020
3076
  "name": "ErrorBoundary",
3021
3077
  "repo": "estiva-ui",
package/src/Button.tsx CHANGED
@@ -32,6 +32,12 @@ import { TooltipTrigger } from './Tooltip'
32
32
  export type ButtonVariant = 'primary' | 'outlined' | 'muted' | 'destructive' | 'resolve'
33
33
  export type ButtonSize = 'default' | 'small'
34
34
 
35
+ /** One labelled action a part draws as its own Button: EmptyState's `action`, EntryShell's. */
36
+ export interface ButtonAction {
37
+ label: string
38
+ onClick: () => void
39
+ }
40
+
35
41
  /**
36
42
  * `ComponentPropsWithRef`, not `ButtonHTMLAttributes`, so a `ref` reaches the
37
43
  * element. React 19 passes `ref` to a function component as an ordinary prop,
@@ -1,6 +1,6 @@
1
1
  import type { ReactNode } from 'react'
2
2
  import { IconMessage2 } from '@tabler/icons-react'
3
- import { Button } from './Button'
3
+ import { Button, type ButtonAction } from './Button'
4
4
  import { cn } from './cn'
5
5
 
6
6
  /**
@@ -34,7 +34,7 @@ export interface EmptyStateProps {
34
34
  * the line as the package's Button, outlined (Katerina, 2026-09-18). A `page`
35
35
  * only: a section's empty line is one line among others, not a stage.
36
36
  */
37
- action?: { label: string; onClick: () => void }
37
+ action?: ButtonAction
38
38
  className?: string
39
39
  }
40
40
 
@@ -0,0 +1,69 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks'
2
+ import * as EntryShellStories from './EntryShell.stories'
3
+
4
+ <Meta of={EntryShellStories} />
5
+
6
+ # EntryShell
7
+
8
+ What an app shows while nobody is signed in to it: its logo, one line saying
9
+ why, and at most one button.
10
+
11
+ <Canvas of={EntryShellStories.MessageWithAction} />
12
+
13
+ ## When
14
+
15
+ - **`busy`**: entry is still being decided. The logo alone, faded in after
16
+ 150ms, so an entry that resolves at once flashes nothing. It carries the
17
+ pulse class too, as Peek's did; the reveal overrides it here, and an app
18
+ that themes the pulse draws its own instead.
19
+ - **A `message` and an `action`**: entry stopped and one thing would get the
20
+ person in.
21
+ - **A `message` alone**: entry stopped and nothing the person can do would
22
+ help, so there is no button.
23
+ - **An `action` alone**: the button with no line over it.
24
+ - **`action.disabled`**: the button held while what it started is still
25
+ running, so a second tap starts nothing.
26
+
27
+ <Canvas of={EntryShellStories.Busy} />
28
+
29
+ <Canvas of={EntryShellStories.MessageOnly} />
30
+
31
+ ## When not
32
+
33
+ - Inside the app's frame. It stands in *for* the whole app while entry is
34
+ decided; a page or a section with nothing to show inside the frame is an
35
+ [**EmptyState**](?path=/docs/feedback-emptystate--docs).
36
+
37
+ ## How
38
+
39
+ ```tsx
40
+ import { EntryShell } from '@estiva-app/ui'
41
+
42
+ <EntryShell logo={appLogo} busy busyLabel="Opening" />
43
+
44
+ <EntryShell
45
+ logo={appLogo}
46
+ message={why}
47
+ action={canRecover ? { label: continueLabel, onClick: start, disabled: starting } : undefined}
48
+ />
49
+ ```
50
+
51
+ - **The words are the caller's**: the line, the button's label and
52
+ `busyLabel`.
53
+ - **`action.onClick` runs from the tap itself.** Start anything that needs the
54
+ person's gesture there, not behind anything asynchronous, and pass
55
+ `disabled` while it runs.
56
+ - **The logo is drawn as given**, at the size the app draws its mark. While
57
+ `busy`, the pulse goes on that element itself, so it must take a
58
+ `className`.
59
+ - **What a screen reader hears**: while `busy`, a busy status named
60
+ `busyLabel` ("Loading" when you pass none); afterwards the line is a polite
61
+ status, read when it appears.
62
+
63
+ ## What it owns
64
+
65
+ Nothing. It only draws. Clicks and keys are yours.
66
+
67
+ ## Props
68
+
69
+ <Controls of={EntryShellStories.MessageWithAction} />
@@ -0,0 +1,48 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite'
2
+ import { IconSquareRounded } from '@tabler/icons-react'
3
+ import { EntryShell } from './EntryShell'
4
+
5
+ // A stand-in for an app's mark, at the 40px an app's logo badge is drawn at.
6
+ const logo = (
7
+ <div role="img" aria-label="Logo" className="flex size-10 items-center justify-center rounded-xl bg-accent-muted text-accent-text">
8
+ <IconSquareRounded size={16} stroke={1.5} />
9
+ </div>
10
+ )
11
+
12
+ const meta = {
13
+ title: 'Frame/EntryShell',
14
+ component: EntryShell,
15
+ parameters: { layout: 'fullscreen' },
16
+ args: { logo },
17
+ argTypes: { logo: { control: false } },
18
+ } satisfies Meta<typeof EntryShell>
19
+
20
+ export default meta
21
+ type Story = StoryObj<typeof meta>
22
+
23
+ /** The line and the one thing to do about it. */
24
+ export const MessageWithAction: Story = {
25
+ args: { message: 'One line saying why the app cannot open yet.', action: { label: 'Continue', onClick: () => {} } },
26
+ }
27
+
28
+ /** The logo alone, faded in after 150ms. */
29
+ export const Busy: Story = {
30
+ args: { busy: true },
31
+ }
32
+
33
+ /** The line alone, when nothing the person can do would help. A longer line wraps at its width. */
34
+ export const MessageOnly: Story = {
35
+ args: {
36
+ message: 'A longer line, for a reason that needs two sentences. It wraps at the width the line is given and stays centred under the logo.',
37
+ },
38
+ }
39
+
40
+ /** The button held while what it started is still running. */
41
+ export const ActionDisabled: Story = {
42
+ args: { message: 'One line saying why the app cannot open yet.', action: { label: 'Continue', onClick: () => {}, disabled: true } },
43
+ }
44
+
45
+ /** The button alone, with no line. */
46
+ export const ActionOnly: Story = {
47
+ args: { action: { label: 'Try again', onClick: () => {} } },
48
+ }
@@ -0,0 +1,69 @@
1
+ // @vitest-environment jsdom
2
+ /**
3
+ * What the page claims: busy draws the logo alone and says so to assistive
4
+ * technology; a stopped entry draws the line (announced politely, never empty)
5
+ * and, only when given one, the button that runs the caller's action from the
6
+ * tap, and holds it while disabled.
7
+ */
8
+ import { afterEach, describe, expect, it, vi } from 'vitest'
9
+ import { cleanup, render, screen } from '@testing-library/react'
10
+ import userEvent from '@testing-library/user-event'
11
+ import { EntryShell } from './EntryShell'
12
+
13
+ afterEach(cleanup)
14
+
15
+ const logo = <span>Logo</span>
16
+
17
+ describe('EntryShell', () => {
18
+ it('shows only the logo while entry is busy, even when given a line and an action', () => {
19
+ render(<EntryShell logo={logo} busy message="Why." action={{ label: 'Continue', onClick: () => {} }} />)
20
+ expect(screen.getByText('Logo')).not.toBeNull()
21
+ expect(screen.queryByText('Why.')).toBeNull()
22
+ expect(screen.queryByRole('button')).toBeNull()
23
+ })
24
+
25
+ it('announces a busy screen as a busy status with its label', () => {
26
+ render(<EntryShell logo={logo} busy busyLabel="Opening" />)
27
+ const status = screen.queryByRole('status', { name: 'Opening' })
28
+ expect(status).not.toBeNull()
29
+ expect(status?.getAttribute('aria-busy')).toBe('true')
30
+ })
31
+
32
+ it('names a busy screen "Loading" when no label is given', () => {
33
+ render(<EntryShell logo={logo} busy />)
34
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeNull()
35
+ })
36
+
37
+ it('shows the line as a polite status and one button that runs the action when pressed', async () => {
38
+ const user = userEvent.setup()
39
+ const onClick = vi.fn()
40
+ render(<EntryShell logo={logo} message="Why." action={{ label: 'Continue', onClick }} />)
41
+ expect(screen.queryByRole('status')?.textContent).toBe('Why.')
42
+ const buttons = screen.getAllByRole('button')
43
+ expect(buttons).toHaveLength(1)
44
+ expect(buttons[0].textContent).toBe('Continue')
45
+ await user.click(buttons[0])
46
+ expect(onClick).toHaveBeenCalledTimes(1)
47
+ })
48
+
49
+ it('does not run a disabled action when its button is pressed', async () => {
50
+ const user = userEvent.setup()
51
+ const onClick = vi.fn()
52
+ render(<EntryShell logo={logo} message="Why." action={{ label: 'Continue', onClick, disabled: true }} />)
53
+ await user.click(screen.getByRole('button', { name: 'Continue' }))
54
+ expect(onClick).not.toHaveBeenCalled()
55
+ })
56
+
57
+ it('shows the line and no button when there is nothing the person can do', () => {
58
+ render(<EntryShell logo={logo} message="Only an administrator can clear this." />)
59
+ expect(screen.getByText('Logo')).not.toBeNull()
60
+ expect(screen.getByText('Only an administrator can clear this.')).not.toBeNull()
61
+ expect(screen.queryByRole('button')).toBeNull()
62
+ })
63
+
64
+ it('draws no line for an empty message, and the button alone', () => {
65
+ const { container } = render(<EntryShell logo={logo} message="" action={{ label: 'Try again', onClick: () => {} }} />)
66
+ expect(container.querySelector('p')).toBeNull()
67
+ expect(screen.getByRole('button', { name: 'Try again' })).not.toBeNull()
68
+ })
69
+ })
@@ -0,0 +1,76 @@
1
+ import { cloneElement, type ReactElement, type ReactNode } from 'react'
2
+ import { Button, type ButtonAction } from './Button'
3
+ import { cn } from './cn'
4
+
5
+ /**
6
+ * What an app shows while nobody is signed in to it: its logo, one line saying
7
+ * why, and at most one button. Peek's AuthShell (PEEK-116), moved here so every
8
+ * app draws the same screen (AUT-3, 2026-10-17).
9
+ *
10
+ * The words are the caller's: a shared part has none of its own for why entry
11
+ * stopped.
12
+ */
13
+ export interface EntryShellProps {
14
+ /**
15
+ * The app's own mark, drawn at the top in every state, as given: the app
16
+ * sizes it. An element that takes a `className`, because while `busy` the
17
+ * pulse goes on the mark itself.
18
+ */
19
+ logo: ReactElement<{ className?: string }>
20
+ /**
21
+ * Entry is still being decided: the logo alone, faded in after 150ms (as a
22
+ * Skeleton is), so an entry that resolves at once flashes nothing. The
23
+ * message and the action are not drawn. Assistive technology hears a busy
24
+ * status named `busyLabel`. The logo carries the pulse class too, as Peek's
25
+ * did; the reveal overrides it here, and an app that themes the pulse (Peek's
26
+ * Signal shimmer) draws its own instead.
27
+ */
28
+ busy?: boolean
29
+ /** What a screen reader hears while `busy`; nothing is drawn for it. */
30
+ busyLabel?: string
31
+ /**
32
+ * The one line saying why nobody is signed in, announced politely when it
33
+ * appears. Nothing is drawn for an empty one.
34
+ */
35
+ message?: ReactNode
36
+ /**
37
+ * The one thing to do about it, drawn under the line (or alone, with no
38
+ * `message`) as the package's primary Button. Leave it out when nothing the
39
+ * person can do would help: a button that cannot work is worse than none.
40
+ * `onClick` runs from the tap itself, so a prompt that needs the person's
41
+ * gesture may start in it; `disabled` holds the button while that runs, so a
42
+ * second tap starts nothing.
43
+ */
44
+ action?: ButtonAction & { disabled?: boolean }
45
+ className?: string
46
+ }
47
+
48
+ const isEmpty = (node: ReactNode) => node == null || node === false || (typeof node === 'string' && node.trim() === '')
49
+
50
+ export function EntryShell({ logo, busy = false, busyLabel = 'Loading', message, action, className }: EntryShellProps) {
51
+ return (
52
+ <div className={cn('min-h-screen bg-bg-base flex items-center justify-center p-6', className)}>
53
+ {busy ? (
54
+ <div role="status" aria-busy="true" aria-label={busyLabel} className="flex flex-col items-center gap-4">
55
+ {/* On the mark itself, not on a box around it: a box would pulse its own square corners
56
+ and, where an app themes the pulse (Peek's Signal shimmer), sweep outside the mark. */}
57
+ {cloneElement(logo, { className: cn(logo.props.className, 'animate-skeleton-in animate-pulse') })}
58
+ </div>
59
+ ) : (
60
+ <div className="flex flex-col items-center gap-4">
61
+ {logo}
62
+ {!isEmpty(message) && (
63
+ <p role="status" className="text-body-2 text-text-secondary max-w-sm text-center">
64
+ {message}
65
+ </p>
66
+ )}
67
+ {action && (
68
+ <Button variant="primary" type="button" onClick={action.onClick} disabled={action.disabled}>
69
+ {action.label}
70
+ </Button>
71
+ )}
72
+ </div>
73
+ )}
74
+ </div>
75
+ )
76
+ }
package/src/index.ts CHANGED
@@ -18,7 +18,7 @@ export { MembersPill, type MembersPillProps } from './MembersPill'
18
18
  export { MembersDialog, type MembersDialogCandidate, type MembersDialogMember, type MembersDialogProps, type MembersDialogSelfAction } from './MembersDialog'
19
19
  export { Banner, type BannerProps, type BannerTone } from './Banner'
20
20
  export { BlockHandle, blockAtY, type BlockHandleProps, type BlockHandleEditing, type HandleBlock } from './BlockHandle'
21
- export { Button, type ButtonProps, type ButtonSize, type ButtonVariant } from './Button'
21
+ export { Button, type ButtonAction, type ButtonProps, type ButtonSize, type ButtonVariant } from './Button'
22
22
  export { Card, type CardAttention, type CardFill, type CardHover, type CardProps } from './Card'
23
23
  export { Checkbox, type CheckboxProps } from './Checkbox'
24
24
  export { Chip, type ChipProps, type ChipType } from './Chip'
@@ -69,6 +69,7 @@ export { DialogShell, type DialogShellProps } from './DialogShell'
69
69
  export { Divider, type DividerProps } from './Divider'
70
70
  export { EditableText, type EditableTextProps } from './EditableText'
71
71
  export { EmptyState, type EmptyStateProps } from './EmptyState'
72
+ export { EntryShell, type EntryShellProps } from './EntryShell'
72
73
  export { ErrorBoundary, type ErrorBoundaryProps } from './ErrorBoundary'
73
74
  export { ProgressBar, type ProgressBarProps, type ProgressBarVariant } from './ProgressBar'
74
75
  export { SkeletonBar, SkeletonList, SkeletonRow } from './Skeleton'
@@ -48,19 +48,19 @@ describe('the registry builds', () => {
48
48
  expect(registry.entries.map((one) => one.name).sort()).toEqual(values.map((one) => one.name).sort())
49
49
  })
50
50
 
51
- it('counts 202 names over 94 files: 137 components, 62 helpers and 3 hooks (CommentBox with commentBoxRows, and ReactionRow with AddReactionButton and whoReacted, the shared comment box and reaction row (COMM-2), on 17 October; the link widgets — LinkChip, LinkRow, LinkCard, CardUnder, PartCard, LinkPreview and their parts, with useCanHover, chosenOf, loadingShapeOf and unavailableMemory — from the Widgets 2 prototype, on 16 October; InlineText, a title or the line under it edited where it stands (SUM-4), on 16 October; ComposeBox with ComposeKeys and its classes, CommentHighlights with its five helpers, and keepSelection and releaseSelection, from the Leaf prototype (LEAF-4), on 16 October;NavTree, NavTreeSection, the composer triggers and UnreadDot joined on 2 October; BlockHandle and EditorBlockHandle (RIC-18) on 2 October, moveBlock and blockDropCursor, the drop in the gutter, on 5 October, MembersPill and MembersDialog, moved from Peek (SHI-31), on 6 October, ShowMore on 7 October, AppProvider on 8 October, and KindIcon, thingKindOf and PastedImages with its two helpers, moved from Peek, on 8 October; CodeBlockColours, the coloured code block of the editor, on 9 October; Checklist, Callout, isChecklistTick and calloutLook (RIC-19) on 13 October; EditorTableControls and its four actions (RIC-21) on 13 October; ReferenceCards, useReferenceCards and its three helpers, the card a chip in a document asks for, on 14 October; LinkChips and its two helpers, a URL in a document read as its chip, on 14 October; ReferenceMenu, ReferenceMenuView and three helpers, the menu of a chip while writing, on 14 October; PastedMarkdown, markdown pasted as the blocks it spells (LEAF-10), on 15 October; turnIntoRows, turnListInto and turnQuoteInto, the block menu’s Turn into for a list and a quote (LEAF-11), on 15 October)', () => {
51
+ it('counts 203 names over 95 files: 138 components, 62 helpers and 3 hooks (EntryShell, the screen while nobody is signed in, moved from Peek (AUT-3), on 17 October; CommentBox with commentBoxRows, and ReactionRow with AddReactionButton and whoReacted, the shared comment box and reaction row (COMM-2), on 17 October; the link widgets — LinkChip, LinkRow, LinkCard, CardUnder, PartCard, LinkPreview and their parts, with useCanHover, chosenOf, loadingShapeOf and unavailableMemory — from the Widgets 2 prototype, on 16 October; InlineText, a title or the line under it edited where it stands (SUM-4), on 16 October; ComposeBox with ComposeKeys and its classes, CommentHighlights with its five helpers, and keepSelection and releaseSelection, from the Leaf prototype (LEAF-4), on 16 October;NavTree, NavTreeSection, the composer triggers and UnreadDot joined on 2 October; BlockHandle and EditorBlockHandle (RIC-18) on 2 October, moveBlock and blockDropCursor, the drop in the gutter, on 5 October, MembersPill and MembersDialog, moved from Peek (SHI-31), on 6 October, ShowMore on 7 October, AppProvider on 8 October, and KindIcon, thingKindOf and PastedImages with its two helpers, moved from Peek, on 8 October; CodeBlockColours, the coloured code block of the editor, on 9 October; Checklist, Callout, isChecklistTick and calloutLook (RIC-19) on 13 October; EditorTableControls and its four actions (RIC-21) on 13 October; ReferenceCards, useReferenceCards and its three helpers, the card a chip in a document asks for, on 14 October; LinkChips and its two helpers, a URL in a document read as its chip, on 14 October; ReferenceMenu, ReferenceMenuView and three helpers, the menu of a chip while writing, on 14 October; PastedMarkdown, markdown pasted as the blocks it spells (LEAF-10), on 15 October; turnIntoRows, turnListInto and turnQuoteInto, the block menu’s Turn into for a list and a quote (LEAF-11), on 15 October)', () => {
52
52
  // The reconciliation GATES.md §24 explains. If this changes, that changes.
53
53
  // The `EDITOR_EXTENSIONS` count as components by their names; they are
54
54
  // editor extensions, documented on SelectionToolbar's, BlockNodes' and
55
55
  // ComposerTriggers' pages.
56
56
  const kinds = registry.entries.reduce<Record<string, number>>((all, one) => ({ ...all, [one.kind]: (all[one.kind] ?? 0) + 1 }), {})
57
- expect(kinds).toEqual({ component: 137, helper: 62, hook: 3 })
58
- expect(new Set(registry.entries.map((one) => one.sourceFile)).size).toBe(94)
57
+ expect(kinds).toEqual({ component: 138, helper: 62, hook: 3 })
58
+ expect(new Set(registry.entries.map((one) => one.sourceFile)).size).toBe(95)
59
59
  })
60
60
 
61
61
  it('gives every entry a purpose, from its own page or from the comment above it', () => {
62
62
  expect(registry.entries.filter((one) => one.purpose.trim() === '')).toEqual([])
63
- expect(registry.entries.filter((one) => one.purposeFrom === 'page').length).toBe(88)
63
+ expect(registry.entries.filter((one) => one.purposeFrom === 'page').length).toBe(89)
64
64
  expect(registry.entries.filter((one) => one.purposeFrom === 'comment').length).toBe(114)
65
65
  })
66
66
 
@@ -148,6 +148,7 @@ the **floating** TopBar goes with the **Rail** and the content card.
148
148
  | A 64px icon strip | **Rail**, filled with **RailItem** tiles |
149
149
  | The menu button and the logo | the TopBar's `menu` and `logo` slots — collapsing stays yours |
150
150
  | Where pictures come from, and how to change page without a reload, said once | **AppProvider**, around the whole app |
151
+ | What shows while nobody is signed in: the logo, one line, at most one button | **EntryShell** — in place of the whole app; `busy` while entry is decided |
151
152
  | The list beside the thing that is open | **ListColumn** — 290px, its name in a **ContainerHeader**, the list under it scrolling |
152
153
  | A panel of a page that is not a list — details, a thread, what is open — with a body that must never be cut off | **Panel** — a header, a body that scrolls whenever it is taller, and a `footer` that stays put |
153
154