@abide/abide 0.118.0 → 0.120.0

package/src/compiler/serveLanguage.ts

@@ -1,11 +1,16 @@
 import { existsSync, type FSWatcher, watch } from 'node:fs' // bun exposes no file watcher or sync existence check of its own
 import { dirname } from 'node:path' // bun exposes no path helpers of its own
+
 import { realOrAsGiven } from '#server/realOrAsGiven.ts'
+
 import { checkSource, lowerApp } from './checkApp.ts'
 import { citedClauses } from './citedClauses.ts'
 import { type AppChecker, openChecker } from './compileApp.ts'
 import { DOCS_SITE } from './DOCS_SITE.ts'
+import { formatAbide } from './formatAbide.ts'
+import { formatDiagnosis } from './formatDiagnosis.ts'
 import { isNamedAlone } from './isNamedAlone.ts'
+import { lineOf, offsetOf } from './lineOf.ts'
 import { nearest } from './nearest.ts'
 import type { Diagnosis, Inspection, Place } from './TypeSession.ts'
 
@@ -290,6 +295,7 @@ export async function serveLanguage(
                             definitionProvider: true,
                             referencesProvider: true,
                             renameProvider: { prepareProvider: true },
+                            documentFormattingProvider: true,
                             completionProvider: {
                                 triggerCharacters: ['.', '<', '#', ':', '/'],
                             },
@@ -392,8 +398,7 @@ export async function serveLanguage(
                 const found = await references(params)
                 const declarations = (
                     params?.context as
-                        | { includeDeclaration?: boolean }
-                        | undefined
+                        { includeDeclaration?: boolean } | undefined
                 )?.includeDeclaration
                 const locations: object[] = []
                 for (const place of found?.occurrences ?? [])
@@ -457,6 +462,45 @@ export async function serveLanguage(
                 })
                 return true
             }
+            case 'textDocument/formatting': {
+                // 38.130 — the text the editor holds, formatted as `abide format` formats a file:
+                // one edit replacing the whole of it, none where nothing moves.
+                const uri = (params?.textDocument as { uri: string }).uri
+                const document = documents.get(uri)
+                if (document === undefined) {
+                    send({ id: message.id, result: null })
+                    return true
+                }
+                const path = Bun.fileURLToPath(uri)
+                const text = document.text
+                const formatted = await formatAbide(path, text)
+                // Shown rather than published: a publish would replace what the check reported.
+                for (const finding of formatted.findings)
+                    send({
+                        method: 'window/showMessage',
+                        params: {
+                            type: 2,
+                            message: formatDiagnosis(finding, dirname(path)),
+                        },
+                    })
+                send({
+                    id: message.id,
+                    result:
+                        formatted.text === text
+                            ? []
+                            : [
+                                  {
+                                      range: rangeOf({
+                                          path,
+                                          start: { line: 1, column: 1 },
+                                          end: lineOf(text, text.length),
+                                      }),
+                                      newText: formatted.text,
+                                  },
+                              ],
+                })
+                return true
+            }
             case 'textDocument/didClose': {
                 const closed = params?.textDocument as { uri: string }
                 if (!documents.delete(closed.uri)) return true
@@ -542,23 +586,6 @@ function wordLength(line: string, character: number): number {
     return word === undefined ? 1 : word.length
 }
 
-/**
- * The protocol's `{ line, character }`, from 0, as an offset into `text`. A character is a UTF-16
- * code unit in the protocol and in a JavaScript string alike.
- */
-function offsetOf(
-    text: string,
-    position: { line: number; character: number },
-): number {
-    let at = 0
-    for (let line = 0; line < position.line; line += 1) {
-        const end = text.indexOf('\n', at)
-        if (end === -1) return text.length
-        at = end + 1
-    }
-    return at + position.character
-}
-
 /** A `Place` at `path`, lines and columns from 1, as the protocol's `Location`, from 0. */
 function locationOf(path: string, place: Place): object {
     return { uri: Bun.pathToFileURL(path).href, range: rangeOf(place) }

package/src/compiler/sharedModuleWrites.ts

@@ -4,9 +4,10 @@ import {
     isVariableDeclarationList,
 } from 'typescript/unstable/ast/is'
 import type {
-    Symbol as CheckedSymbol,
     Checker,
+    Symbol as CheckedSymbol,
 } from 'typescript/unstable/async'
+
 import { classifyRead, FUNCTIONS } from './classifyRead.ts'
 import type { Finding } from './Finding.ts'
 import type { Span } from './projectShadow.ts'

package/src/compiler/sourceMapOf.ts

@@ -11,6 +11,7 @@
 // What no chunk covers is the framework's own scaffolding, and maps to nothing.
 
 import { encodeMappings, type Segment } from '#server/sourceMappings.ts'
+
 import type { LoweredChunk } from './Lowering.ts'
 import type { Origin } from './projectShadow.ts'
 import { mapBack } from './ShadowMap.ts'

package/src/compiler/splitImports.ts

@@ -1,5 +1,7 @@
 import { SyntaxKind } from 'typescript/unstable/ast'
+
 import { COMPONENT_QUERY, TEXT_QUERY } from '#server/MODULE_QUERIES.ts'
+
 import { isContextualKeyword, type Token, tokenize } from './tokenize.ts'
 
 /**

package/src/compiler/templateWarnings.ts

@@ -2,12 +2,12 @@ import type { CheckerAnswer } from './CheckerAnswer.ts'
 import type { Read } from './classifyRead.ts'
 import { isComponentTag } from './classifyTemplate.ts'
 import { isNamedAlone } from './isNamedAlone.ts'
-import { Lowering } from './Lowering.ts'
 import { diagnosisAt } from './lineOf.ts'
+import { Lowering } from './Lowering.ts'
 import type { AbideFile } from './parseAbide.ts'
 import {
-    type Body,
     bodiesOf,
+    type Body,
     type ForBlock,
     type TemplateNode,
     visitBodies,

package/src/compiler/trackingWarnings.ts

@@ -14,6 +14,7 @@ import {
     isPropertyAccessExpression,
     isWhileStatement,
 } from 'typescript/unstable/ast/is'
+
 import { FUNCTIONS, TRANSPARENT } from './classifyRead.ts'
 import type { Finding } from './Finding.ts'
 import type { PositionKind, PositionTable } from './PositionTable.ts'

package/src/compiler/writeDefaultProject.ts

@@ -11,6 +11,7 @@
 import { mkdtemp, rm } from 'node:fs/promises' // bun exposes no temporary-directory creation or recursive removal of its own
 import { tmpdir } from 'node:os' // bun exposes no temporary-directory path of its own
 import { dirname, resolve } from 'node:path' // bun exposes no path helpers of its own
+
 import { nearest } from './nearest.ts'
 
 /** What every abide app in the docs and the scaffold is written against. */
@@ -33,7 +34,10 @@ export async function writeDefaultProject(
     await Bun.write(
         tsconfig,
         JSON.stringify({
-            compilerOptions: { ...COMPILER_OPTIONS, paths: await aliasPaths(root) },
+            compilerOptions: {
+                ...COMPILER_OPTIONS,
+                paths: await aliasPaths(root),
+            },
             include: [`${root}/**/*`],
         }),
     )

package/src/server/BRIDGE_SCHEME.ts

@@ -0,0 +1,3 @@
+// 44.40 — the scheme a pairing link is written in, which the handler `abide-bridge install` registers
+// opens. The bridge spells it out as `PAIRING_SCHEME`, and a test holds the two equal.
+export const BRIDGE_SCHEME = 'abide-bridge'

package/src/server/BRIDGE_VERSION.ts

@@ -1,3 +1,3 @@
 // The `abide-bridge` release a pairing command names, so a visitor's `bunx` runs the relay this
 // server speaks. `packages/abide/tests/claudeCode.test.ts` holds it to the bridge package's own.
-export const BRIDGE_VERSION = '0.3.4'
+export const BRIDGE_VERSION = '0.4.0'

package/src/server/abideModules.ts

@@ -18,7 +18,9 @@
 // to this one rather than registering a plugin nobody asks.
 
 import { basename, dirname, resolve } from 'node:path' // bun exposes no path helpers of its own
+
 import { SERVER_SPECIFIER } from '#shared/SPECIFIERS.ts'
+
 import type { ServerTable } from './answerRequest.ts'
 import type { MountRow } from './answerRpc.ts'
 import {

package/src/server/answerFailure.ts

@@ -7,6 +7,7 @@ import { type Failed, problemOf } from '#shared/Failed.ts'
 import { RENDER_LOG } from '#shared/log.ts'
 import { coversPrefix, partsOf } from '#shared/matchRoute.ts'
 import { coversRoute, parseRoutePattern } from '#shared/routePattern.ts'
+
 import type { AppSources } from './answerRequest.ts'
 import { DOCUMENT_HEADERS } from './DOCUMENT_HEADERS.ts'
 import { boundPage, renderDocument } from './render.ts'

package/src/server/answerRequest.ts

@@ -19,23 +19,23 @@ import {
 } from '#shared/ADDRESSES.ts'
 import { APP_META } from '#shared/APP_META.ts'
 import { DEBUG_META } from '#shared/DEBUG_META.ts'
-import { ICON_ADDRESSES } from '#shared/LAUNCHER_FILES.ts'
-import { OFFLINE_META } from '#shared/OFFLINE_META.ts'
 import { decodedOrKept } from '#shared/decodedOrKept.ts'
 import { ERROR_META } from '#shared/ERROR_META.ts'
 import { escapeAttribute } from '#shared/escapeText.ts'
 import { type Failed, isFailed } from '#shared/Failed.ts'
 import { HandlerRoute } from '#shared/HandlerRoute.ts'
+import { health } from '#shared/health.ts'
 import { KEEP_HEADER } from '#shared/KEEP_HEADER.ts'
 import { KEEP_OPENED } from '#shared/KEEP_OPENED.ts'
-import { health } from '#shared/health.ts'
+import { ICON_ADDRESSES } from '#shared/LAUNCHER_FILES.ts'
 import { appName } from '#shared/log.ts'
-import { compose } from '#shared/Middleware.ts'
-import { MOUNT_META } from '#shared/MOUNT_META.ts'
 import { matchOf, type Params, partsOf } from '#shared/matchRoute.ts'
+import { compose } from '#shared/Middleware.ts'
 import { MOUNT, mounted } from '#shared/mount.ts'
+import { MOUNT_META } from '#shared/MOUNT_META.ts'
 import { NAVIGATION_HEADER } from '#shared/NAVIGATION_HEADER.ts'
-import { refuse, notFound as refusedNotFound } from '#shared/refuse.ts'
+import { OFFLINE_META } from '#shared/OFFLINE_META.ts'
+import { notFound as refusedNotFound, refuse } from '#shared/refuse.ts'
 import { arrive } from '#shared/route.ts'
 import {
     parseRoutePattern,
@@ -44,29 +44,30 @@ import {
 } from '#shared/routePattern.ts'
 import type { Method, Rpc } from '#shared/rpc.ts'
 import { rpcRequest } from '#shared/rpcRequest.ts'
+
 import { answered, answerFailure } from './answerFailure.ts'
 import {
     answerRpc,
     type Mounted,
-    type MountRow,
     mountedOwn,
     mountHandlers,
+    type MountRow,
 } from './answerRpc.ts'
 import { answerBlobTagged, answerValue, contentEtag } from './answerValue.ts'
-import { answerBridge } from './bridgeRelay.ts'
-import { CLIENT_ENTRY } from './CLIENT_BUILD.ts'
-import { appManifest } from './appManifest.ts'
 import { answerWorker } from './answerWorker.ts'
+import { appManifest } from './appManifest.ts'
+import { answerBridge } from './bridgeRelay.ts'
 import { callerOrMint } from './callerOf.ts'
-import { settingOn } from './config.ts'
+import { CLIENT_ENTRY } from './CLIENT_BUILD.ts'
 import { compressAnswer } from './compressAnswer.ts'
-import { DOCUMENT_HEADERS } from './DOCUMENT_HEADERS.ts'
-import { OFFLINE_STALE } from './OFFLINE_STALE.ts'
+import { settingOn } from './config.ts'
 import { noteCallInRender } from './deferredBuilds.ts'
+import { DOCUMENT_HEADERS } from './DOCUMENT_HEADERS.ts'
 import { answerMcp, openApi } from './generatedSurfaces.ts'
 import { type AppRung, failureOf, rungsOver } from './hooks.ts'
 import { chunksOf, type Manifest } from './manifestOf.ts'
 import { muxAdmission } from './muxUpgrade.ts'
+import { OFFLINE_STALE } from './OFFLINE_STALE.ts'
 import { plainAnswer } from './plainAnswer.ts'
 import { prefers } from './prefers.ts'
 import { PRINCIPAL_MOUNT } from './principal.ts'
@@ -78,8 +79,8 @@ import {
     renderDocument,
 } from './render.ts'
 import {
-    type AnsweringApp,
     adoptRequest,
+    type AnsweringApp,
     beginRender,
     currentRequestScope,
     type PageRender,

package/src/server/answerRpc.ts

@@ -11,15 +11,16 @@ import { GLOBAL_GETS } from '#shared/GLOBAL_GETS.ts'
 import { isRecord } from '#shared/isRecord.ts'
 import type { JsonValue } from '#shared/JsonValue.ts'
 import { mounted as underMount } from '#shared/mount.ts'
-import { RPC_SERVER } from '#shared/RPC_SERVER.ts'
 import type { Gated } from '#shared/reactive/argsContract.ts'
 import { deadlineOf, heldGenerationOf } from '#shared/reactive/index.ts'
 import type { Defaults } from '#shared/reactive/parameterDefaults.ts'
 import { notFound, refuse } from '#shared/refuse.ts'
 import type { HeldToAnnotation, Method, Rpc } from '#shared/rpc.ts'
+import { RPC_SERVER } from '#shared/RPC_SERVER.ts'
 import { argsInURL } from '#shared/rpcRequest.ts'
 import { VERSION_HEADER } from '#shared/VERSION_HEADER.ts'
 import { versionInEtag } from '#shared/versionInEtag.ts'
+
 import {
     answered,
     answerFailure,
@@ -29,7 +30,6 @@ import {
 import { followAsEvents } from './answerSocket.ts'
 import { answerValue, namesEtag, sseHeaders } from './answerValue.ts'
 import { argsFor } from './argsFor.ts'
-import { OFFLINE_STALE } from './OFFLINE_STALE.ts'
 import { callerOf } from './callerOf.ts'
 import {
     argsDocumentOf,
@@ -45,6 +45,7 @@ import {
     crossingRefusal,
 } from './crossingOrigin.ts'
 import { type AppRung, failureOf, rungsOver } from './hooks.ts'
+import { OFFLINE_STALE } from './OFFLINE_STALE.ts'
 import { prefers } from './prefers.ts'
 import {
     currentRequestScope,

package/src/server/answerSocket.ts

@@ -23,6 +23,7 @@ import { PATCH_SINKS } from '#shared/reactive/PATCH_SINKS.ts'
 import { unowned } from '#shared/reactive/watch.ts'
 import { refuse } from '#shared/refuse.ts'
 import { rpcRequest } from '#shared/rpcRequest.ts'
+
 import { handlerKey, type Mounted } from './answerRpc.ts'
 import { argsFor } from './argsFor.ts'
 import { positiveSetting } from './config.ts'
@@ -32,8 +33,8 @@ import { sendOrClose } from './muxUpgrade.ts'
 import {
     heldByApp,
     inOpenScope,
-    type RequestScope,
     releaseScope,
+    type RequestScope,
     scopeFor,
 } from './requestScope.ts'
 import { EVENT_STREAM_OPENER, streamEvent } from './streamEvent.ts'

package/src/server/answerValue.ts

@@ -4,6 +4,7 @@
 // `Values` a handler returned — framed one chunk per pull (16.32, 16.44–16.47).
 
 import { isFailed, problemOf } from '#shared/Failed.ts'
+
 import { compressAnswer } from './compressAnswer.ts'
 import { prefers } from './prefers.ts'
 import {

package/src/server/answerWorker.ts

@@ -19,6 +19,7 @@ import {
 } from '#shared/OFFLINE_CACHES.ts'
 import { PRINCIPAL_HEADER } from '#shared/PRINCIPAL_HEADER.ts'
 import { REACHED_MESSAGE } from '#shared/REACHED_MESSAGE.ts'
+
 import type { Manifest } from './manifestOf.ts'
 
 // What `framingOf` reads as a framed stream (16.32), and a binary's bytes (16.34), which may be one —

package/src/server/appTree.ts

@@ -13,19 +13,21 @@
 // can drop them.
 
 import { type Dirent, existsSync, readdirSync } from 'node:fs' // bun has no directory listing or sync existence check of its own
+
 import type { Refusals } from '#compiler/Refusals.ts'
 import { ABIDE_ADDRESS } from '#shared/ADDRESSES.ts'
 import {
     PUBLIC_DIRECTORY,
     RESERVED_DIRECTORIES,
 } from '#shared/RESERVED_DIRECTORIES.ts'
+
 import {
     DIRECTORY_FILES,
+    isBenchFile,
     isDeclarationFile,
     isHandlerFile,
     isParamFile,
     isServerFile,
-    isBenchFile,
     isTestFile,
     placeOf,
     routeOf,

package/src/server/argsFor.ts

@@ -5,6 +5,7 @@
 import { DERIVED_ARGS } from '#shared/DERIVED_ARGS.ts'
 import { normalized } from '#shared/reactive/argsContract.ts'
 import { validationError } from '#shared/refuse.ts'
+
 import type { Mounted } from './answerRpc.ts'
 import { coerceArgs } from './coerceArgs.ts'
 

package/src/server/assistant.ts

@@ -12,8 +12,9 @@
 
 import { namedLogger } from '#shared/log.ts'
 import { refuse } from '#shared/refuse.ts'
-import { IMAGE_TYPES } from './IMAGE_TYPES.ts'
+
 import { type McpReply, McpSurface } from './generatedSurfaces.ts'
+import { IMAGE_TYPES } from './IMAGE_TYPES.ts'
 import { request, within } from './requestScope.ts'
 
 /** A piece of a turn: words, or an image as base64 with its type. */

package/src/server/banner.ts

@@ -1,6 +1,8 @@
 import { networkInterfaces } from 'node:os' // bun exposes no network interface list of its own
+
 import { useColor } from '#shared/log.ts'
 import { paint as painted } from '#shared/paint.ts'
+
 import type { AppPackage } from './config.ts'
 
 /**

package/src/server/bridgeRelay.ts

@@ -15,6 +15,7 @@
 
 import { isFailed } from '#shared/Failed.ts'
 import { refuse } from '#shared/refuse.ts'
+
 import { answered } from './answerFailure.ts'
 import { bodyWithin } from './answerRpc.ts'
 import { framed } from './answerValue.ts'

package/src/server/callerOf.ts

@@ -1,4 +1,5 @@
 import { cookies } from '#shared/cookies.ts'
+
 import { randomToken } from './randomToken.ts'
 import {
     currentRequestScope,

package/src/server/claudeApi.ts

@@ -8,6 +8,7 @@
 
 import { framedStream } from '#shared/framing.ts'
 import { refuse } from '#shared/refuse.ts'
+
 import { blocksOf, type Provider, textOf } from './assistant.ts'
 
 /** A Messages API request body, less what abide writes, with the client's key and origin. */

package/src/server/claudeCode.ts

@@ -10,6 +10,7 @@
 
 import { mounted } from '#shared/mount.ts'
 import { refuse } from '#shared/refuse.ts'
+
 import {
     type AssistantContent,
     type AssistantEvent,
@@ -18,6 +19,7 @@ import {
     forwardOf,
     type Provider,
 } from './assistant.ts'
+import { BRIDGE_SCHEME } from './BRIDGE_SCHEME.ts'
 import { BRIDGE_VERSION } from './BRIDGE_VERSION.ts'
 import {
     followSignIn,
@@ -49,8 +51,15 @@ export type ClaudeCodeConfig = {
 /** The built-in tools a pairing command grants, as the visitor would after its `--`. 44.32. */
 type PairingOptions = Pick<ClaudeCodeConfig, 'tools'>
 
-/** Whether this browser's bridge is connected, and the command that pairs one where it is not. */
-export type BridgeStatus = { paired: boolean; command: string | undefined }
+/**
+ * Whether this browser's bridge is connected, and the command and the link that pair one where it is
+ * not.
+ */
+export type BridgeStatus = {
+    paired: boolean
+    command: string | undefined
+    link: string | undefined
+}
 
 /** The visitor's own Claude Code, reached through the bridge paired to their browser. */
 function claudeCodeProvider(config: ClaudeCodeConfig = {}): Provider {
@@ -148,35 +157,40 @@ function askingCaller(): string {
     return caller
 }
 
+/** One pairing code, as the command a visitor runs and the link they open, and when it stops standing. */
+type Pairing = { command: string; link: string; expires: number }
+
 /**
- * The command that pairs a bridge with this browser, and when its code stops standing. 44.14. The
- * `tools` it is given are written after its `--`, so the visitor running it grants them (44.29, 44.32).
+ * The command and the link that pair a bridge with this browser, and when their code stops standing.
+ * 44.14. The `tools` it is given are written after the command's `--` and in the link, so the visitor
+ * running either grants them (44.29, 44.32, 44.40).
  */
-function bridgeCommand(options: PairingOptions = {}): {
-    command: string
-    expires: number
-} {
+function bridgeCommand(options: PairingOptions = {}): Pairing {
     return commandFor(askingCaller(), signedInAs(), options)
 }
 
-/** The command pairing a bridge with `caller` signed in as `signedIn` (44.33). */
+/** The command and the link pairing a bridge with `caller` signed in as `signedIn` (44.33). */
 function commandFor(
     caller: string,
     signedIn: string,
     { tools }: PairingOptions,
-): { command: string; expires: number } {
+): Pairing {
     const { code, expires } = mintCode(caller, signedIn)
     const site = `${appOrigin() ?? new URL(request().url).origin}${mounted('')}`
-    const grant = tools?.length ? ` -- --tools ${tools.join(',')}` : ''
+    const granted = tools?.length ? tools.join(',') : undefined
+    const query = new URLSearchParams({ site, code, version: BRIDGE_VERSION })
+    if (granted !== undefined) query.set('tools', granted)
+    const grant = granted === undefined ? '' : ` -- --tools ${granted}`
     return {
         command: `bunx @abide/bridge@${BRIDGE_VERSION} ${site} ${code}${grant}`,
+        link: `${BRIDGE_SCHEME}://pair?${query}`,
         expires,
     }
 }
 
 /**
- * This browser's pairing as it changes: unpaired with the command to run, then paired the moment a
- * bridge connects, and unpaired again if it goes. 44.20.
+ * This browser's pairing as it changes: unpaired with the command to run and the link to open, then
+ * paired the moment a bridge connects, and unpaired again if it goes. 44.20.
  *
  * 44.34 — IT FOLLOWS WHOEVER SIGNS IN AT THE BROWSER, though its own request carries the cookies it
  * opened with: a sign-in or a sign-out made since is the pairing it watches from then on, and the
@@ -202,7 +216,7 @@ async function* bridge(
         rouse()
     }
     signal.addEventListener('abort', rouse)
-    let pairing: { command: string; expires: number } | undefined
+    let pairing: Pairing | undefined
     let said = ''
     try {
         while (!signal.aborted) {
@@ -224,7 +238,9 @@ async function* bridge(
             const status: BridgeStatus = {
                 paired,
                 command: paired ? undefined : pairing?.command,
+                link: paired ? undefined : pairing?.link,
             }
+            // The link is minted with the command, so the command alone tells a new pairing.
             const saying = `${status.paired} ${status.command}`
             if (saying !== said) {
                 said = saying

package/src/server/clientBundle.ts

@@ -7,6 +7,7 @@
 // long a browser may keep it.
 
 import { CLIENT_ADDRESS } from '#shared/ADDRESSES.ts'
+
 import { abideModules, type Compilation, tablePath } from './abideModules.ts'
 import { appPlugins } from './appPlugins.ts'
 import { CLIENT_ENTRY } from './CLIENT_BUILD.ts'

package/src/server/coerceArgs.ts

@@ -19,8 +19,7 @@ export type Document = {
 /** The document a handler's `args` schema declares, or `undefined`. */
 export function argsDocumentOf(handler: Gated<unknown>): Document | undefined {
     const gate = gateOf(handler) as
-        | { '~standard'?: { jsonSchema?: { input?: () => unknown } } }
-        | undefined
+        { '~standard'?: { jsonSchema?: { input?: () => unknown } } } | undefined
     const document = gate?.['~standard']?.jsonSchema?.input?.()
     return document !== null && typeof document === 'object'
         ? (document as Document)

package/src/server/commands.ts

@@ -5,8 +5,10 @@
 
 import { resolve } from 'node:path' // bun exposes no path helpers of its own
 import { parseArgs } from 'node:util' // bun exposes no argv parser of its own yet
+
 import { MCP_ADDRESS, OPENAPI_ADDRESS } from '#shared/ADDRESSES.ts'
 import { IN_PROCESS_ORIGIN } from '#shared/IN_PROCESS_ORIGIN.ts'
+
 import { banner } from './banner.ts'
 import { type App, type AppHandle, enterApp } from './createApp.ts'
 import { stopOnSignalOrFault } from './faultPolicy.ts'
@@ -32,6 +34,7 @@ type SourceCommands = Record<
     | 'dev'
     | 'build'
     | 'check'
+    | 'format'
     | 'routes'
     | 'compile'
     | 'bundle'
@@ -194,6 +197,11 @@ function commandsOf(host: Host): Row[] {
             'type-check the templates and the TypeScript, on the line you wrote',
             'check',
         ),
+        fromSource(
+            'format [--check] [dir…]',
+            'format every .abide — its code by bun fmt, its markup by its nesting',
+            'format',
+        ),
         fromSource(
             'routes [--json]',
             'every address the app answers, its file, and where each hook is filed',
@@ -288,6 +296,7 @@ function parseFlags(argv: string[]) {
             target: { type: 'string' },
             platforms: { type: 'string' },
             json: { type: 'boolean' },
+            check: { type: 'boolean' },
             help: { type: 'boolean', short: 'h' },
             version: { type: 'boolean', short: 'v' },
         },

package/src/server/compressAnswer.ts

@@ -10,9 +10,10 @@
 // BUN'S GZIP parts from zlib's past ~130 KB, which only the off-loop lane reaches — so that lane takes
 // zlib's, the loop keeps bun's, and the two make the same bytes.
 import { brotliCompress, brotliCompressSync, constants, gzip } from 'node:zlib' // bun has no brotli, and no compression off the loop
+
 import {
-    ENCODINGS,
     type Encoding,
+    ENCODINGS,
     negotiateEncoding,
 } from './negotiateEncoding.ts'
 

package/src/server/config.ts

@@ -5,11 +5,13 @@
 // and a throw out of `onConfig` is the value's standing error, which a read throws (27.1).
 
 import { homedir } from 'node:os' // bun exposes no home directory of its own
+
 import { isRecord } from '#shared/isRecord.ts'
 import { numberFromText } from '#shared/numberFromText.ts'
 import { reactive } from '#shared/reactive/index.ts'
 import { validationError } from '#shared/refuse.ts'
 import { runSchema } from '#shared/Schema.ts'
+
 import { appDirectories } from './appDirectories.ts'
 import { type Env, HOOKS, inOrder } from './hooks.ts'
 import { withoutTrailingSlash } from './withoutTrailingSlash.ts'