@abide/abide 0.109.0 → 0.110.0

package/docs/abide.md

@@ -305,20 +305,21 @@ A file's path below `src` is its address. Nothing else names a route.
 | `src/contacts/index.abide` | `/contacts` |
 | `src/contacts/listContacts.ts` | `GET /contacts/listContacts`, the handler its default export declares |
 | `src/contacts/lib/ContactList.abide` | no address: a component the pages import |
-| `src/contacts/tests/ContactList.test.ts` | no address: what `bun test` runs |
+| `src/contacts/lib/ContactList.test.ts` | no address: what `bun test` runs |
 
-Code that is not an address goes in a directory that never is. The directory also decides where the code runs:
+Code that is not an address goes in a directory that never is, and a file's name decides where it runs:
 
-| Directory | What goes in it | Where it runs |
+| Path | What goes in it | Where it runs |
 | --- | --- | --- |
-| `src/**` | the app | both sides, unless its directory says otherwise |
+| `src/**` | the app | both sides, unless its name says otherwise |
 | `src/**/` | pages, layouts and handler files, routed by their path | a page on both sides; a handler on the server, with a call in its place in the browser |
 | `**/lib/**` | components and modules | wherever they are imported |
-| `**/server/**` | the database, secrets, anything the browser never loads | the server alone; a page importing it is a compile error |
-| `**/tests/**` | tests | `bun test`, never served |
+| `**/lib/**/<name>.server.<extension>` | the database, secrets, anything the browser never loads | the server alone; a page importing it is a compile error |
+| `**/<name>.test.ts` | tests, beside what they test | `bun test`, never served |
+| `**/<name>.d.ts` | types, beside what they type | nowhere; the checker reads them |
 | `**/public/**` | files answered as they are | nowhere; each is sent at its path |
 
-Any other file beside the pages fails the build, so listing a directory lists its routes. The CRM keeps its contacts in `src/contacts/server/CONTACTS.ts`, and only the handler reads it.
+Any other file beside the pages fails the build, so listing a directory lists its routes. The CRM keeps its contacts in `src/contacts/lib/CONTACTS.server.ts`, and only the handler reads it.
 
 ## A page reads a handler like a value
 
@@ -341,7 +342,7 @@ const contacts = reactive(() => listContacts())
 
 ```ts src/contacts/listContacts.ts
 import { GET } from '@abide/abide/server'
-import { CONTACTS } from './server/CONTACTS.ts'
+import { CONTACTS } from './lib/CONTACTS.server.ts'
 
 export default GET(async () => {
     // A slow database, so the wait is on screen.
@@ -350,7 +351,7 @@ export default GET(async () => {
 })
 ```
 
-```ts src/contacts/tests/ContactList.test.ts
+```ts src/contacts/lib/ContactList.test.ts
 import { expect, test } from 'bun:test'
 import listContacts from '../listContacts.ts'
 
@@ -401,7 +402,7 @@ async function requestPage() {
 </ul>
 ```
 
-```ts src/contacts/tests/PageTiming.test.ts
+```ts src/contacts/lib/PageTiming.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -440,11 +441,11 @@ let starred = reactive(false)
 </div>
 ```
 
-```ts src/contacts/tests/StarButton.test.ts
+```ts src/contacts/lib/StarButton.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import StarButton from '../lib/StarButton.abide'
+import StarButton from './StarButton.abide'
 
 test('the click writes starred and the button follows', async () => {
     using _button = await mount(StarButton({}))
@@ -492,11 +493,11 @@ let saved = reactive<string>()
 </div>
 ```
 
-```ts src/contacts/tests/ContactNote.test.ts
+```ts src/contacts/lib/ContactNote.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import ContactNote from '../lib/ContactNote.abide'
+import ContactNote from './ContactNote.abide'
 
 const savedNote = () => document.querySelectorAll('strong')[3]?.textContent
 
@@ -564,11 +565,11 @@ let email = reactive('ada@example.com')
 </ul>
 ```
 
-```ts src/profile/tests/ContactFields.test.ts
+```ts src/profile/lib/ContactFields.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import ContactFields from '../lib/ContactFields.abide'
+import ContactFields from './ContactFields.abide'
 
 test('typing writes the value, and the value fills the field', async () => {
     using _fields = await mount(ContactFields({}))
@@ -627,11 +628,11 @@ let phone = reactive('', {
 </label>
 ```
 
-```ts src/profile/tests/PhoneField.test.ts
+```ts src/profile/lib/PhoneField.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import PhoneField from '../lib/PhoneField.abide'
+import PhoneField from './PhoneField.abide'
 
 test('the record keeps the digits, and the field shows them back', async () => {
     using _phone = await mount(PhoneField({}))
@@ -676,11 +677,11 @@ const filled = reactive(() => [name, phone].filter(Boolean).length)
 </ul>
 ```
 
-```ts src/profile/tests/ProfileSummary.test.ts
+```ts src/profile/lib/ProfileSummary.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { measure, mount } from '@abide/harness/abide'
-import ProfileSummary from '../lib/ProfileSummary.abide'
+import ProfileSummary from './ProfileSummary.abide'
 
 const shown = () =>
     [...document.querySelectorAll('strong')].map((one) => one.textContent)
@@ -736,11 +737,11 @@ let contact = reactive({
 </ul>
 ```
 
-```ts src/profile/tests/AddressField.test.ts
+```ts src/profile/lib/AddressField.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import AddressField from '../lib/AddressField.abide'
+import AddressField from './AddressField.abide'
 
 test('a write to the city reaches the record it sits in', async () => {
     using _address = await mount(AddressField({}))
@@ -798,11 +799,11 @@ let tags = reactive(['investor', 'speaker', 'mentor'])
 </div>
 ```
 
-```ts src/profile/tests/Tags.test.ts
+```ts src/profile/lib/Tags.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { measure, mount } from '@abide/harness/abide'
-import Tags from '../lib/Tags.abide'
+import Tags from './Tags.abide'
 
 test('removing a tag removes its row and rewrites no other', async () => {
     using _tags = await mount(Tags({}))
@@ -841,11 +842,11 @@ let followUp = reactive(false)
 {/if}
 ```
 
-```ts src/profile/tests/FollowUp.test.ts
+```ts src/profile/lib/FollowUp.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import FollowUp from '../lib/FollowUp.abide'
+import FollowUp from './FollowUp.abide'
 
 const dateField = () => document.querySelector('input[type="date"]')
 
@@ -896,11 +897,11 @@ const { name } = props<{ name: string }>()
 </span>
 ```
 
-```ts src/profile/tests/ContactCard.test.ts
+```ts src/profile/lib/ContactCard.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { measure, mount } from '@abide/harness/abide'
-import ContactCard from '../lib/ContactCard.abide'
+import ContactCard from './ContactCard.abide'
 
 test('the avatar follows its name prop, and is not rebuilt', async () => {
     using _card = await mount(ContactCard({}))
@@ -965,10 +966,10 @@ import LeadBadge from './LeadBadge.abide'
 </style>
 ```
 
-```ts src/profile/tests/StageBadges.test.ts
+```ts src/profile/lib/StageBadges.test.ts
 import { expect, test } from 'bun:test'
 import { mount } from '@abide/harness/abide'
-import StageBadges from '../lib/StageBadges.abide'
+import StageBadges from './StageBadges.abide'
 
 // The scope token: an attribute every rule in a `<style>` requires.
 const tokensOf = (element: Element) =>
@@ -1034,11 +1035,11 @@ let calls = reactive(0)
     <button onclick={() => (calls += 1)}>Log a call</button></li>
 ```
 
-```ts src/profile/tests/CallLog.test.ts
+```ts src/profile/lib/CallLog.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import CallLog from '../lib/CallLog.abide'
+import CallLog from './CallLog.abide'
 
 const rows = () =>
     [...document.querySelectorAll('li')].map((row) =>
@@ -1119,7 +1120,7 @@ const deal = reactive(() => getDeal({ id }))
 ```ts src/deals/getDeal.ts
 import { refuse } from '@abide/abide'
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 /** Answers at /deals/getDeal?id=…; the argument type is the schema. */
 export default GET(
@@ -1132,7 +1133,7 @@ export default GET(
 )
 ```
 
-```ts src/deals/tests/DealDetail.test.ts
+```ts src/deals/lib/DealDetail.test.ts
 import { expect, test } from 'bun:test'
 import getDeal from '../getDeal.ts'
 
@@ -1179,7 +1180,7 @@ const notes = reactive(() => getNotes({ id: 'd1' }))
 </ul>
 ```
 
-```ts src/deals/tests/DealNotes.test.ts
+```ts src/deals/lib/DealNotes.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -1255,7 +1256,7 @@ async function add() {
 ```ts src/deals/createDeal.ts
 import { jsonSchema } from '@abide/abide'
 import { POST } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 type NewDeal = { name: string; company: string; amount: number }
 
@@ -1286,7 +1287,7 @@ export default POST(
 )
 ```
 
-```ts src/deals/tests/NewDeal.test.ts
+```ts src/deals/lib/NewDeal.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -1375,7 +1376,7 @@ async function move(stage: string) {
 ```ts src/deals/moveDeal.ts
 import { jsonSchema, refuse } from '@abide/abide'
 import { PATCH } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 // A refusal with a name and typed data, which the page can match.
 const dealClosed = refuse.named(
@@ -1398,7 +1399,7 @@ export default PATCH(
 )
 ```
 
-```ts src/deals/tests/DealStage.test.ts
+```ts src/deals/lib/DealStage.test.ts
 import { expect, test } from 'bun:test'
 import moveDeal from '../moveDeal.ts'
 
@@ -1441,7 +1442,7 @@ import exportDeals from '../exportDeals.ts'
 
 ```ts src/deals/exportDeals.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 /** A Blob answers with its own type: this one is a CSV file. */
 export default GET(
@@ -1455,7 +1456,7 @@ export default GET(
 )
 ```
 
-```ts src/deals/tests/ExportDeals.test.ts
+```ts src/deals/lib/ExportDeals.test.ts
 import { expect, test } from 'bun:test'
 import exportDeals from '../exportDeals.ts'
 
@@ -1537,7 +1538,7 @@ const total = reactive(() => {
 
 ```ts src/deals/listDeals.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 export default GET(
     async () => {
@@ -1549,7 +1550,7 @@ export default GET(
 )
 ```
 
-```ts src/deals/tests/Pipeline.test.ts
+```ts src/deals/lib/Pipeline.test.ts
 import { expect, test } from 'bun:test'
 import { reactive, refresh } from '@abide/abide'
 import listDeals from '../listDeals.ts'
@@ -1656,8 +1657,8 @@ const totals = reactive(() => getStage({ stage }))
 
 ```ts src/pipeline/getStage.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
-import { LOADS } from './server/LOADS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
+import { LOADS } from './lib/LOADS.server.ts'
 
 /** Takes args, so it is keyed: one entry per stage. */
 export default GET(
@@ -1678,12 +1679,12 @@ export default GET(
 )
 ```
 
-```ts src/pipeline/tests/StageTiles.test.ts
+```ts src/pipeline/lib/StageTiles.test.ts
 import { expect, test } from 'bun:test'
 import { mount } from '@abide/harness/abide'
 import getStage from '../getStage.ts'
-import StageTiles from '../lib/StageTiles.abide'
-import { LOADS } from '../server/LOADS.ts'
+import StageTiles from './StageTiles.abide'
+import { LOADS } from './LOADS.server.ts'
 
 function pick(index: number, stage: string): void {
     const select = document.querySelectorAll('select')[index]
@@ -1747,8 +1748,8 @@ const reloading = reactive(() => forecast.busy() && forecast.ready())
 
 ```ts src/pipeline/getForecast.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
-import { LOADS } from './server/LOADS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
+import { LOADS } from './lib/LOADS.server.ts'
 
 // How likely a deal in each stage is to close.
 const ODDS: Record<string, number> = {
@@ -1773,12 +1774,12 @@ export default GET(
 )
 ```
 
-```ts src/pipeline/tests/Forecast.test.ts
+```ts src/pipeline/lib/Forecast.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import Forecast from '../lib/Forecast.abide'
-import { LOADS } from '../server/LOADS.ts'
+import Forecast from './Forecast.abide'
+import { LOADS } from './LOADS.server.ts'
 
 function press(label: string): void {
     for (const button of document.querySelectorAll('button'))
@@ -1868,7 +1869,7 @@ const totals = reactive(() => getStage({ stage }))
 
 ```ts src/pipeline/winDeal.ts
 import { POST } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 /** Moves the first open lead to won, and answers with its id. */
 export default POST(
@@ -1881,12 +1882,12 @@ export default POST(
 )
 ```
 
-```ts src/pipeline/tests/StageBoard.test.ts
+```ts src/pipeline/lib/StageBoard.test.ts
 import { expect, test } from 'bun:test'
 import { mount } from '@abide/harness/abide'
-import { STAGES } from '../lib/STAGES.ts'
-import StageBoard from '../lib/StageBoard.abide'
-import { LOADS } from '../server/LOADS.ts'
+import { STAGES } from './STAGES.ts'
+import StageBoard from './StageBoard.abide'
+import { LOADS } from './LOADS.server.ts'
 
 function counted(): number[] {
     return STAGES.map((stage) => LOADS[stage] ?? 0)
@@ -1944,8 +1945,8 @@ const found = reactive(() => searchDeals({ q }), { debounce: 300 })
 
 ```ts src/pipeline/searchDeals.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
-import { LOADS } from './server/LOADS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
+import { LOADS } from './lib/LOADS.server.ts'
 
 /** The deals whose name holds the query, ignoring case. */
 export default GET(
@@ -1963,11 +1964,11 @@ export default GET(
 )
 ```
 
-```ts src/pipeline/tests/DealSearch.test.ts
+```ts src/pipeline/lib/DealSearch.test.ts
 import { expect, test } from 'bun:test'
 import { mount } from '@abide/harness/abide'
-import DealSearch from '../lib/DealSearch.abide'
-import { LOADS } from '../server/LOADS.ts'
+import DealSearch from './DealSearch.abide'
+import { LOADS } from './LOADS.server.ts'
 
 function type(text: string): void {
     const input = document.querySelector('input')
@@ -2048,7 +2049,7 @@ function applyNextUpdate() {
 
 ```ts src/pipeline/listDeals.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 /** Every open deal, as a list. */
 export default GET(
@@ -2061,11 +2062,11 @@ export default GET(
 )
 ```
 
-```ts src/pipeline/tests/DealFeed.test.ts
+```ts src/pipeline/lib/DealFeed.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { measure, mount } from '@abide/harness/abide'
-import DealFeed from '../lib/DealFeed.abide'
+import DealFeed from './DealFeed.abide'
 
 test('an update rewrites one amount and builds nothing', async () => {
     using _feed = await mount(DealFeed({}))
@@ -2151,11 +2152,11 @@ const deal = reactive(() =>
 </ul>
 ```
 
-```ts src/pipeline/tests/DealPicker.test.ts
+```ts src/pipeline/lib/DealPicker.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import DealPicker from '../lib/DealPicker.abide'
+import DealPicker from './DealPicker.abide'
 
 test('picking a deal in the list shows it in the detail panel', async () => {
     using _picker = await mount(DealPicker({}))
@@ -2213,8 +2214,8 @@ watch(() => {
 
 ```ts src/pipeline/saveNote.ts
 import { POST } from '@abide/abide/server'
-import { LOADS } from './server/LOADS.ts'
-import { NOTES } from './server/NOTES.ts'
+import { LOADS } from './lib/LOADS.server.ts'
+import { NOTES } from './lib/NOTES.server.ts'
 
 /** Saves the note on a deal. */
 export default POST(
@@ -2226,12 +2227,12 @@ export default POST(
 )
 ```
 
-```ts src/pipeline/tests/DealNote.test.ts
+```ts src/pipeline/lib/DealNote.test.ts
 import { expect, test } from 'bun:test'
 import { mount } from '@abide/harness/abide'
-import DealNote from '../lib/DealNote.abide'
-import { LOADS } from '../server/LOADS.ts'
-import { NOTES } from '../server/NOTES.ts'
+import DealNote from './DealNote.abide'
+import { LOADS } from './LOADS.server.ts'
+import { NOTES } from './NOTES.server.ts'
 
 test('a burst of typing is saved once, after it stops', async () => {
     using _note = await mount(DealNote({}))
@@ -2323,7 +2324,7 @@ export function preferenceStore(name: string): Store<string> {
 
 ```ts src/pipeline/getPreference.ts
 import { GET } from '@abide/abide/server'
-import { PREFERENCES } from './server/PREFERENCES.ts'
+import { PREFERENCES } from './lib/PREFERENCES.server.ts'
 
 /** A saved preference, or `null` where none was saved. */
 export default GET(
@@ -2338,7 +2339,7 @@ export default GET(
 
 ```ts src/pipeline/setPreference.ts
 import { POST } from '@abide/abide/server'
-import { PREFERENCES } from './server/PREFERENCES.ts'
+import { PREFERENCES } from './lib/PREFERENCES.server.ts'
 
 /** Saves a preference. */
 export default POST(
@@ -2349,12 +2350,12 @@ export default POST(
 )
 ```
 
-```ts src/pipeline/tests/PipelineView.test.ts
+```ts src/pipeline/lib/PipelineView.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import PipelineView from '../lib/PipelineView.abide'
-import { PREFERENCES } from '../server/PREFERENCES.ts'
+import PipelineView from './PipelineView.abide'
+import { PREFERENCES } from './PREFERENCES.server.ts'
 
 function chosen(): string | undefined {
     const tab = document.querySelector('[aria-selected="true"]')
@@ -2458,11 +2459,11 @@ const last = reactive(() => activity.at(-1))
 </ul>
 ```
 
-```ts src/activity/tests/QuickLog.test.ts
+```ts src/activity/lib/QuickLog.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import QuickLog from '../lib/QuickLog.abide'
+import QuickLog from './QuickLog.abide'
 
 test('a reader the logger never names follows what it logs', async () => {
     using _log = await mount(QuickLog({}))
@@ -2524,11 +2525,11 @@ export function logActivity(contact: string, kind: string): void {
 }
 ```
 
-```ts src/activity/tests/RecentActivity.test.ts
+```ts src/activity/lib/RecentActivity.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import RecentActivity from '../lib/RecentActivity.abide'
+import RecentActivity from './RecentActivity.abide'
 
 test('logging past three adds one entry and drops the oldest', async () => {
     using _recent = await mount(RecentActivity({}))
@@ -2620,7 +2621,7 @@ export default POST(
 )
 ```
 
-```ts src/activity/tests/AccountFeed.test.ts
+```ts src/activity/lib/AccountFeed.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -2702,7 +2703,7 @@ export default GET(
 )
 ```
 
-```ts src/activity/tests/ActivityHistory.test.ts
+```ts src/activity/lib/ActivityHistory.test.ts
 import { expect, test } from 'bun:test'
 import olderActivity from '../olderActivity.ts'
 
@@ -2774,7 +2775,7 @@ export default GET(() => bytes(csvOf()), {
 })
 ```
 
-```ts src/activity/tests/CsvExport.test.ts
+```ts src/activity/lib/CsvExport.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -2839,7 +2840,7 @@ export default GET(() => sse(MOVES), {
 })
 ```
 
-```ts src/activity/tests/Wallboard.test.ts
+```ts src/activity/lib/Wallboard.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -2963,7 +2964,7 @@ const company = reactive(() => getCompany({ id: route.params.id }))
 </style>
 ```
 
-```ts src/companies/tests/CompanyPage.test.ts
+```ts src/companies/CompanyPage.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3004,7 +3005,7 @@ import { url } from '@abide/abide'
 ```abide src/companies/layout.abide
 <script server>
 import { onError } from '@abide/abide/server'
-import { tracker } from './server/tracker.ts'
+import { tracker } from './lib/tracker.server.ts'
 
 onError((error) => tracker.capture(error))
 </script>
@@ -3025,7 +3026,7 @@ let note = reactive('')
 <slot/>
 ```
 
-```ts src/companies/tests/Layout.test.ts
+```ts src/companies/Layout.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3093,7 +3094,7 @@ let draft = reactive('')
 </ul>
 ```
 
-```ts src/companies/tests/CompanyTabs.test.ts
+```ts src/companies/lib/CompanyTabs.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3169,7 +3170,7 @@ const company = reactive(() => getCompany({ id: route.params.id }))
 </style>
 ```
 
-```ts src/companies/tests/ViewTransition.test.ts
+```ts src/companies/ViewTransition.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3243,7 +3244,7 @@ function followTitle(element: Element) {
 ```abide src/companies/layout.abide
 <script server>
 import { onError } from '@abide/abide/server'
-import { tracker } from './server/tracker.ts'
+import { tracker } from './lib/tracker.server.ts'
 
 onError((error) => tracker.capture(error))
 </script>
@@ -3288,7 +3289,7 @@ const company = reactive(() => getCompany({ id: route.params.id }))
 </style>
 ```
 
-```ts src/companies/tests/Head.test.ts
+```ts src/companies/Head.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3356,7 +3357,7 @@ const company = reactive(() => getCompany({ id: route.params.id }))
 
 ```ts src/companies/getCompany.ts
 import { GET, notFound } from '@abide/abide/server'
-import { COMPANIES } from './server/COMPANIES.ts'
+import { COMPANIES } from './lib/COMPANIES.server.ts'
 
 /** Answers at /companies/getCompany; a company's page reads it. */
 export default GET(
@@ -3372,7 +3373,7 @@ export default GET(
 )
 ```
 
-```ts src/companies/tests/Streaming.test.ts
+```ts src/companies/Streaming.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3431,7 +3432,7 @@ const { failure } = props<{ failure: Failed<string, unknown> }>()
 
 ```ts src/companies/getCompany.ts
 import { GET, notFound } from '@abide/abide/server'
-import { COMPANIES } from './server/COMPANIES.ts'
+import { COMPANIES } from './lib/COMPANIES.server.ts'
 
 /** Answers at /companies/getCompany; a company's page reads it. */
 export default GET(
@@ -3447,7 +3448,7 @@ export default GET(
 )
 ```
 
-```ts src/companies/tests/ErrorPage.test.ts
+```ts src/companies/ErrorPage.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3514,7 +3515,7 @@ export default POST(
 ```abide src/companies/layout.abide
 <script server>
 import { onError } from '@abide/abide/server'
-import { tracker } from './server/tracker.ts'
+import { tracker } from './lib/tracker.server.ts'
 
 onError((error) => tracker.capture(error))
 </script>
@@ -3535,7 +3536,7 @@ let note = reactive('')
 <slot/>
 ```
 
-```ts src/companies/tests/ExportButton.test.ts
+```ts src/companies/lib/ExportButton.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3576,7 +3577,7 @@ import previewCompany from '../previewCompany.ts'
 ```ts src/companies/previewCompany.ts
 import { GET, notFound, page, render } from '@abide/abide/server'
 import CompanySheet from './lib/CompanySheet.abide'
-import { COMPANIES } from './server/COMPANIES.ts'
+import { COMPANIES } from './lib/COMPANIES.server.ts'
 
 /** Answers at /companies/previewCompany: an account sheet, as its own page. */
 export default GET(
@@ -3610,7 +3611,7 @@ const { company } = props<{
 </html>
 ```
 
-```ts src/companies/tests/SheetPreview.test.ts
+```ts src/companies/lib/SheetPreview.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3686,7 +3687,7 @@ let email = reactive('maya@crm.example')
 ```ts src/account/signIn.ts
 import { principal, refuse } from '@abide/abide'
 import { onPrincipal, POST } from '@abide/abide/server'
-import { TEAM } from './server/TEAM.ts'
+import { TEAM } from './lib/TEAM.server.ts'
 
 /** Seals the member's id into the cookie, and nothing else. */
 export default POST(
@@ -3713,7 +3714,7 @@ import { POST } from '@abide/abide/server'
 export default POST(() => principal.clear(), { description: 'Signs out.' })
 ```
 
-```ts src/account/tests/SignIn.test.ts
+```ts src/account/lib/SignIn.test.ts
 import { expect, test } from 'bun:test'
 import { principal } from '@abide/abide'
 import { createApp } from '@abide/abide/server'
@@ -3783,7 +3784,7 @@ import SignInAs from './SignInAs.abide'
 ```ts src/account/signIn.ts
 import { principal, refuse } from '@abide/abide'
 import { onPrincipal, POST } from '@abide/abide/server'
-import { TEAM } from './server/TEAM.ts'
+import { TEAM } from './lib/TEAM.server.ts'
 
 /** Seals the member's id into the cookie, and nothing else. */
 export default POST(
@@ -3803,7 +3804,7 @@ onPrincipal((claims) => {
 })
 ```
 
-```ts src/account/tests/Badge.test.ts
+```ts src/account/lib/Badge.test.ts
 import { expect, test } from 'bun:test'
 import { principal } from '@abide/abide'
 import { createApp } from '@abide/abide/server'
@@ -3830,7 +3831,7 @@ test('the cookie holds an id, and the request reads the member', async () => {
 
 `onPrincipal` is handed the claims and returns your half of the caller. It runs on the server, at most once per request, where the team records are. So the cookie stays small, and a rename shows on the next request rather than at the next sign-in. Filed in any handler file or `.abide`, it resolves the caller for every route.
 
-What it returns is read as `principal.resolved`, typed by `Principal`. Declare your fields on that interface, as the app's `server/TEAM.ts` does beside the team it reads. abide's own three fields are `authenticated`, `expiresAt` and `error`, and they win any collision, so a resolver cannot sign a caller in by returning `authenticated: true`. A resolver that throws fills `error` and leaves the caller signed out.
+What it returns is read as `principal.resolved`, typed by `Principal`. Declare your fields on that interface, as the app's `lib/TEAM.server.ts` does beside the team it reads. abide's own three fields are `authenticated`, `expiresAt` and `error`, and they win any collision, so a resolver cannot sign a caller in by returning `authenticated: true`. A resolver that throws fills `error` and leaves the caller signed out.
 
 The tabs on this card, the deal-value card and the export card are `lib/SignInAs.abide`, which calls the same `signIn` handler.
 
@@ -3860,7 +3861,7 @@ const density = reactive(() => cookies().get('density') ?? 'comfortable')
 </ul>
 ```
 
-```ts src/account/tests/Density.test.ts
+```ts src/account/lib/Density.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -3929,7 +3930,7 @@ export default GET(
 )
 ```
 
-```ts src/account/tests/ContactCard.test.ts
+```ts src/account/lib/ContactCard.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 import getContact from '../getContact.ts'
@@ -3989,7 +3990,7 @@ async function exportAll() {
 ```ts src/account/exportContacts.ts
 import { principal, refuse } from '@abide/abide'
 import { POST } from '@abide/abide/server'
-import { CONTACTS } from '../contacts/server/CONTACTS.ts'
+import { CONTACTS } from '../contacts/lib/CONTACTS.server.ts'
 
 export default POST(async () => CONTACTS, {
     description: 'Every contact, for an admin to export.',
@@ -4004,7 +4005,7 @@ export default POST(async () => CONTACTS, {
 })
 ```
 
-```ts src/account/tests/ExportContacts.test.ts
+```ts src/account/lib/ExportContacts.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 import exportContacts from '../exportContacts.ts'
@@ -4109,7 +4110,7 @@ export default GET(() => ({ account: 'A-1042', balance: '$2,140.00' }), {
 })
 ```
 
-```ts src/account/tests/PartnerStatement.test.ts
+```ts src/account/lib/PartnerStatement.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4201,7 +4202,7 @@ export default GET(
 )
 ```
 
-```ts src/account/tests/SalesReport.test.ts
+```ts src/account/lib/SalesReport.test.ts
 import { expect, test } from 'bun:test'
 import salesReport from '../salesReport.ts'
 
@@ -4271,7 +4272,7 @@ async function sync() {
 ```ts src/account/syncContact.ts
 import { refuse } from '@abide/abide'
 import { POST, reachable } from '@abide/abide/server'
-import { billingOrigin } from './server/billing.ts'
+import { billingOrigin } from './lib/billing.server.ts'
 
 /** Refuses at once while billing is down, rather than waiting on every call. */
 export default POST(
@@ -4291,7 +4292,7 @@ export default POST(
 )
 ```
 
-```ts src/account/tests/SyncContact.test.ts
+```ts src/account/lib/SyncContact.test.ts
 import { expect, test } from 'bun:test'
 import { reachable } from '@abide/abide/server'
 
@@ -4370,7 +4371,7 @@ export default POST(
 )
 ```
 
-```ts src/account/tests/AddContact.test.ts
+```ts src/account/lib/AddContact.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4447,7 +4448,7 @@ middleware(csp())
 </html>
 ```
 
-```ts src/account/tests/Widget.test.ts
+```ts src/account/lib/Widget.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4528,7 +4529,7 @@ export default GET(() => ({ retries: config().RETRIES }), {
 RETRIES=5
 ```
 
-```ts src/ops/tests/Retries.test.ts
+```ts src/ops/lib/Retries.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4596,7 +4597,7 @@ const times = reactive(() => getPool())
 
 ```ts src/ops/getPool.ts
 import { GET, onStart } from '@abide/abide/server'
-import { pool } from './server/pool.ts'
+import { pool } from './lib/pool.server.ts'
 
 // Connect before the app answers anything; note when it came up.
 onStart(async (start) => {
@@ -4611,7 +4612,7 @@ export default GET(() => ({ connectedAt: pool.connectedAt, upAt: pool.upAt }), {
 })
 ```
 
-```ts src/ops/tests/Pool.test.ts
+```ts src/ops/lib/Pool.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4662,13 +4663,13 @@ const sync = log.named('sync')
 </ul>
 ```
 
-```ts src/ops/tests/Console.test.ts
+```ts src/ops/lib/Console.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { createApp } from '@abide/abide/server'
 import { mount } from '@abide/harness/abide'
 import manifest from '../../../package.json' with { type: 'json' }
-import Console from '../lib/Console.abide'
+import Console from './Console.abide'
 
 test('DEBUG writes the billing line and not the poll', async () => {
     // Booting resolves the app's name, which every namespace starts with.
@@ -4780,7 +4781,7 @@ export const billing = {
 }
 ```
 
-```ts src/ops/tests/Sync.test.ts
+```ts src/ops/lib/Sync.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4831,7 +4832,7 @@ With `timing`, a span joins `server-timing` under its name, so the name has to b
 ```abide src/ops/lib/Health.abide
 <script server>
 import { onHealth } from '@abide/abide/server'
-import { pool } from '../server/pool.ts'
+import { pool } from './pool.server.ts'
 
 // Lets a page read `account.database` as a string.
 declare module '@abide/abide' {
@@ -4855,7 +4856,7 @@ const account = health()
 </ul>
 ```
 
-```ts src/ops/tests/Health.test.ts
+```ts src/ops/lib/Health.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -4899,11 +4900,11 @@ import { online } from '@abide/abide'
 </ul>
 ```
 
-```ts src/ops/tests/OfflineBanner.test.ts
+```ts src/ops/lib/OfflineBanner.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import OfflineBanner from '../lib/OfflineBanner.abide'
+import OfflineBanner from './OfflineBanner.abide'
 
 test('the banner shows while the browser is offline, and goes', async () => {
     using _banner = await mount(OfflineBanner({}))
@@ -4990,7 +4991,7 @@ async function readDocument() {
 
 ```ts src/assistant/searchContacts.ts
 import { GET } from '@abide/abide/server'
-import { CONTACTS } from '../contacts/server/CONTACTS.ts'
+import { CONTACTS } from '../contacts/lib/CONTACTS.server.ts'
 
 /** One handler: an OpenAPI operation, an MCP tool and a command. */
 export default GET(
@@ -5000,7 +5001,7 @@ export default GET(
 )
 ```
 
-```ts src/assistant/tests/OpenApiOperation.test.ts
+```ts src/assistant/lib/OpenApiOperation.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5089,7 +5090,7 @@ async function callAsAModel() {
 
 ```ts src/assistant/searchContacts.ts
 import { GET } from '@abide/abide/server'
-import { CONTACTS } from '../contacts/server/CONTACTS.ts'
+import { CONTACTS } from '../contacts/lib/CONTACTS.server.ts'
 
 /** One handler: an OpenAPI operation, an MCP tool and a command. */
 export default GET(
@@ -5099,7 +5100,7 @@ export default GET(
 )
 ```
 
-```ts src/assistant/tests/ModelToolCall.test.ts
+```ts src/assistant/lib/ModelToolCall.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5179,7 +5180,7 @@ async function check() {
 
 ```ts src/assistant/exportContacts.ts
 import { GET } from '@abide/abide/server'
-import { CONTACTS } from '../contacts/server/CONTACTS.ts'
+import { CONTACTS } from '../contacts/lib/CONTACTS.server.ts'
 
 // Every contact at once: for the export button, not for a model.
 export default GET(() => CONTACTS, {
@@ -5188,7 +5189,7 @@ export default GET(() => CONTACTS, {
 })
 ```
 
-```ts src/assistant/tests/WithheldExport.test.ts
+```ts src/assistant/lib/WithheldExport.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5306,7 +5307,7 @@ export default POST(
 )
 ```
 
-```ts src/assistant/tests/AssistantChat.test.ts
+```ts src/assistant/lib/AssistantChat.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5446,7 +5447,7 @@ export default POST(
 )
 ```
 
-```ts src/assistant/tests/ClaudeApiRequest.test.ts
+```ts src/assistant/lib/ClaudeApiRequest.test.ts
 import { expect, spyOn, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5577,7 +5578,7 @@ export default POST(
 )
 ```
 
-```ts src/assistant/tests/ClaudeCodeBridge.test.ts
+```ts src/assistant/lib/ClaudeCodeBridge.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5703,7 +5704,7 @@ const summary = reactive(() => getSummary())
 
 ```ts src/reports/getSummary.ts
 import { GET } from '@abide/abide/server'
-import { DEALS } from './server/DEALS.ts'
+import { DEALS } from './lib/DEALS.server.ts'
 
 /** Answers at /reports/getSummary; the summary tiles and their test read it. */
 export default GET(
@@ -5721,7 +5722,7 @@ export default GET(
 )
 ```
 
-```ts src/reports/tests/PipelineSummary.test.ts
+```ts src/reports/lib/PipelineSummary.test.ts
 import { expect, test } from 'bun:test'
 import { createApp } from '@abide/abide/server'
 
@@ -5749,7 +5750,7 @@ test('the summary answers in process as it does on the wire', async () => {
 
 Hold the app with `await using` and it stops when the test ends, a failed one included. An app nobody stops leaves open whatever `onStart` opened, and the suite hangs with no report at all.
 
-A file under `**/tests/**` has no address, so a test sits beside the feature it tests and is never served.
+A `.test.ts` has no address, so a test sits beside the file it tests and is never served.
 
 ## A test mounts a component and counts what a click did
 
@@ -5798,11 +5799,11 @@ export function closedTotals(days: number) {
 }
 ```
 
-```ts src/reports/tests/ClosedTiles.test.ts
+```ts src/reports/lib/ClosedTiles.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { measure, mount } from '@abide/harness/abide'
-import ClosedTiles from '../lib/ClosedTiles.abide'
+import ClosedTiles from './ClosedTiles.abide'
 
 test('a range switch rewrites two numbers and builds nothing', async () => {
     using _tiles = await mount(ClosedTiles({}))
@@ -5837,6 +5838,8 @@ The DOM under `bun test` comes from one line in `bunfig.toml`, which the scaffol
 ```toml bunfig.toml
 # A DOM to mount into and measure, and `.abide` files as components.
 [test]
+# Bun's tests are under src; e2e holds the browser's, which playwright runs.
+root = "src"
 preload = ["@abide/harness/abide/preload"]
 ```
 
@@ -5909,12 +5912,12 @@ export function summarizeStage(stage: string) {
 }
 ```
 
-```ts src/reports/tests/StageTiles.test.ts
+```ts src/reports/lib/StageTiles.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
 import { measure, publishedBy } from '@abide/harness/measure'
-import StageTiles from '../lib/StageTiles.abide'
+import StageTiles from './StageTiles.abide'
 
 test('three tiles read one summary, worked out once per switch', async () => {
     using _tiles = await mount(StageTiles({}))
@@ -5976,13 +5979,13 @@ export const money = {
 }
 ```
 
-```ts src/reports/tests/WonDeals.test.ts
+```ts src/reports/lib/WonDeals.test.ts
 import { expect, spyOn } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
 import { gate } from '@abide/harness/gate'
-import { money } from '../lib/money.ts'
-import WonDeals from '../lib/WonDeals.abide'
+import { money } from './money.ts'
+import WonDeals from './WonDeals.abide'
 
 gate(
     'a won deal is formatted without building a formatter',
@@ -6090,11 +6093,11 @@ export function advance(deals: Deal[], index: number): Deal[] {
 }
 ```
 
-```ts src/reports/tests/Forecast.test.ts
+```ts src/reports/lib/Forecast.test.ts
 import { expect, test } from 'bun:test'
 import { flushSync } from '@abide/abide'
 import { mount } from '@abide/harness/abide'
-import Forecast from '../lib/Forecast.abide'
+import Forecast from './Forecast.abide'
 
 test('advancing a deal moves the forecast by its weighted amount', async () => {
     using _forecast = await mount(Forecast({}))
@@ -6107,10 +6110,10 @@ test('advancing a deal moves the forecast by its weighted amount', async () => {
 })
 ```
 
-```ts src/reports/tests/Forecast.bench.ts
+```ts src/reports/lib/Forecast.bench.ts
 import { reactive } from '@abide/abide'
 import { type Batched, batch } from '@abide/harness/report'
-import { advance, type Deal, forecast } from '../lib/forecast.ts'
+import { advance, type Deal, forecast } from './forecast.ts'
 
 // The forecast as the card keeps it, over a pipeline of `count` deals.
 function pipeline(count: number): () => void {
@@ -6209,7 +6212,7 @@ export function topFive(by: 'amount' | 'idle') {
 }
 ```
 
-```ts src/reports/tests/TopDeals.e2e.ts
+```ts e2e/TopDeals.test.ts
 import { shares, traceOp } from '@abide/harness/engine'
 import { expect, test } from '@playwright/test'
 
@@ -6286,12 +6289,12 @@ export function dealsOf(count: number): ExportedDeal[] {
 }
 ```
 
-```ts src/reports/tests/DealsExport.test.ts
+```ts src/reports/lib/DealsExport.test.ts
 import { expect, test } from 'bun:test'
 import { render } from '@abide/abide/server'
 import { bytes } from '@abide/harness/server'
-import DealsExport from '../lib/DealsExport.abide'
-import { dealsOf } from '../lib/dealsOf.ts'
+import DealsExport from './DealsExport.abide'
+import { dealsOf } from './dealsOf.ts'
 
 const exportOf = async (count: number) =>
     bytes(await render(DealsExport({ deals: dealsOf(count) })))
@@ -8842,9 +8845,10 @@ Configuration: what is written in place rather than imported.
 | Path | Meaning | Rules |
 | --- | --- | --- |
 | `src/**` | The app's source. | [36.10](/rulebook#36.10), [38.25](/rulebook#38.25) |
-| `**/server/**` | Source the browser never loads. | [16.29](/rulebook#16.29), [23.15](/rulebook#23.15), [23.16](/rulebook#23.16), [23.18](/rulebook#23.18), [36.10](/rulebook#36.10) |
-| `**/lib/**` | The app's code that is no address: components and modules, on both sides. | [23.15](/rulebook#23.15), [23.16](/rulebook#23.16), [23.18](/rulebook#23.18), [23.22](/rulebook#23.22), [37.1](/rulebook#37.1) |
-| `**/tests/**` | The app's tests. | [23.15](/rulebook#23.15), [23.16](/rulebook#23.16), [23.18](/rulebook#23.18), [23.22](/rulebook#23.22), [37.1](/rulebook#37.1), [38.109](/rulebook#38.109) |
+| `**/lib/**` | The app's code that is no address: components and modules. | [23.15](/rulebook#23.15), [23.16](/rulebook#23.16), [23.18](/rulebook#23.18), [23.22](/rulebook#23.22), [37.1](/rulebook#37.1) |
+| `**/lib/**/<name>.server.<extension>` | A server file: source the browser never loads. | [16.29](/rulebook#16.29), [23.23](/rulebook#23.23), [34.20](/rulebook#34.20), [36.10](/rulebook#36.10) |
+| `**/<name>.test.ts` | A test file: one of the app's tests, wherever it lies. | [23.22](/rulebook#23.22), [38.109](/rulebook#38.109) |
+| `**/<name>.d.ts` | A declaration file: types for the checker, wherever it lies. | [23.22](/rulebook#23.22) |
 | `**/public/**` | The files answered as authored, at their path below that directory. | [23.15](/rulebook#23.15), [23.16](/rulebook#23.16), [23.18](/rulebook#23.18), [36.11](/rulebook#36.11), [36.12](/rulebook#36.12), [36.13](/rulebook#36.13), [36.14](/rulebook#36.14), [36.15](/rulebook#36.15), [36.17](/rulebook#36.17), [21.12](/rulebook#21.12), [21.13](/rulebook#21.13), [21.14](/rulebook#21.14), [38.18](/rulebook#38.18), [38.19](/rulebook#38.19) |
 | `src/public/favicon.ico` | The file answered at `/favicon.ico`. | [36.11](/rulebook#36.11) |
 | `src/public/robots.txt` | The file answered at `/robots.txt`. | [36.11](/rulebook#36.11) |