ugly-app 0.1.988 → 0.1.990

package/README.md

@@ -1,15 +1,14 @@
 # ugly-app
 
-A full-stack TypeScript framework for shipping production web apps. Scaffold
-with `npx ugly-app init my-app` and you get an opinionated Node + React +
-Postgres stack with type-safe RPC over WebSocket and HTTP, real-time doc
-subscriptions, built-in auth, AI generation, storage, workers, cron, and a CLI
-for every workflow.
+A full-stack TypeScript framework for shipping production web apps: Node +
+React + Postgres, type-safe RPC over WebSocket and HTTP, real-time doc
+subscriptions, built-in auth, AI generation, storage, cron / workers, and a
+CLI for every workflow.
 
-ugly-app is designed to run against [ugly.bot](https://ugly.bot), which
-provides auth, infra (Postgres, Qdrant, NATS, S3-compatible object storage),
-AI provider keys, push, email, and deployment. Your app talks to all of it
-through the project's dev tunnel and its `UGLY_BOT_TOKEN`.
+ugly-app runs against [ugly.bot](https://ugly.bot), which provides auth,
+infra (Postgres, Qdrant, NATS, S3-compatible object storage), AI provider
+keys, email, push, and deployment. Your app talks to all of it through the
+project's dev tunnel and its `UGLY_BOT_TOKEN`.
 
 ```bash
 npx ugly-app init my-app
@@ -21,8 +20,8 @@ npm run dev
 
 | Import path | Contents |
 |-------------|----------|
-| `ugly-app` (a.k.a. `ugly-app/server`) | Server: `createApp`, `TypedDB`, auth, AI clients, storage, NATS, workers. |
-| `ugly-app/shared` | Cross-tier: `defineRequests`, `defineCollections`, `definePage`, `defineWorkers`, Zod, experiments. |
+| `ugly-app` (a.k.a. `ugly-app/server`) | Server: `createApp`, `TypedDB`, auth, AI clients, storage, NATS. |
+| `ugly-app/shared` | Cross-tier: `defineRequests`, `defineCollections`, `definePage`, `defineWorkers`, Zod, experiments, model catalogs. |
 | `ugly-app/client` | React: `bootstrapApp`, `createRouter`, `lazyPage` / `lazyPageLoader`, `AppProvider` / `useApp`, `SimpleScrollView`, animations, audio, AI helpers. |
 | `ugly-app/server/adapter/workers` | Cloudflare Workers entry (Hono router + Durable Objects + Neon HTTP driver + R2). |
 | `ugly-app/server/ssr` | SSR renderer used by the Workers adapter. |
@@ -35,7 +34,7 @@ Additional per-feature bundles: `conversation`, `character`, `collab`,
 
 ---
 
-## Server — `createApp()`
+## 1. Server — `createApp()`
 
 `createApp` is the single server entry. It owns Express, the WebSocket
 server, the typed DB, and the RPC dispatcher.
@@ -108,7 +107,7 @@ for in-process invocation of any registered handler.
 
 | Member | Description |
 |--------|-------------|
-| `start(port?)` | Start the server (templates use 4321). |
+| `start(port?)` | Start the server. Framework default is `3000`; templates pass `PORT` (default `4321`). |
 | `db` | `TypedDB<Map>` — map inferred from your collections + framework built-ins. |
 | `httpServer` | The underlying Node `http.Server`. |
 | `wss` | The main `WebSocketServer` (path set via `setWsPath`, default `/rpc`). |
@@ -180,7 +179,6 @@ override the framework's defaults. Rate-limited handlers are marked below.
 | `shareLink` | Mint a `https://ugly.bot/l/<code>` short link with OG metadata. Rate-limited 60/60s. |
 | `feedbackReportCreateNoAuth` | Public, same-origin feedback endpoint used by browser telemetry. Rate-limited 10/60s. |
 | `feedbackReportResolve` | Mark an in-app feedback report resolved/declined. Admin-gated. |
-| `submitFeedbackBot` | Feedback path used by the bot-swarm test tooling. |
 | `errorLogCaptureNoAuth` | Public error-log capture. |
 | `perfSnapshotCaptureNoAuth` | Public perf snapshot capture. Rate-limited 60/60s. |
 | `adminGetPerfLogs` | Admin-only perf log query used by the CLI `perf:*` commands. |
@@ -192,98 +190,12 @@ Add per-endpoint rate limits on your own handlers with
 
 ---
 
-## Shared API definitions
-
-`shared/` is consumed by both server and client. Keep all Zod schemas,
-types, collections, and route declarations here.
-
-### Requests (`shared/api.ts`)
-
-```ts
-import { authReq, defineRequests, req, z } from 'ugly-app/shared';
-
-export const requests = defineRequests({
-  // Public — handler signature: (userId: string | null, input) => Promise<output>
-  getPublicData: req({
-    input: z.object({ id: z.string() }),
-    output: z.object({ data: z.string() }),
-  }),
-
-  // Authenticated — 401 enforced automatically, userId guaranteed string
-  getMe: authReq({
-    input: z.object({}),
-    output: z.object({ userId: z.string(), email: z.string().optional() }),
-  }),
-
-  // Per-endpoint rate limiting — enforced before the handler runs
-  submitFeedback: authReq({
-    input: z.object({ type: z.enum(['bug', 'design', 'feature']), message: z.string() }),
-    output: z.object({ id: z.string() }),
-    rateLimit: { max: 20, window: 60 },
-  }),
-});
-```
-
-Every request is reachable as **both** `socket.request(name, input)`
-(WebSocket) and `POST /api/:name { input }` (HTTP). `z` is re-exported from
-Zod for convenience.
-
-### Collections (`shared/collections.ts`)
-
-```ts
-import { defineCollections, InferDocType, neon } from 'ugly-app/shared';
-import { z } from 'zod';
-
-export const TodoSchema = z.object({
-  userId: z.string(),
-  text: z.string(),
-  done: z.boolean(),
-});
-export type Todo = InferDocType<typeof TodoSchema>;
-
-export const collections = defineCollections({
-  todo: {
-    schema: TodoSchema,
-    meta: {
-      db: neon,                // REQUIRED — `neon` (Postgres) or `d1` (SQLite / D1)
-      cache: true,             // or { ttlMs: 60_000 }
-      trackable: true,
-      public: false,
-      cascadeFrom: null,
-    },
-  },
-});
-```
-
-**`CollectionMeta`:**
-- `db` — **required.** `neon` (Postgres) or `d1` (Cloudflare D1 / SQLite). Both handles are exported from `ugly-app/shared`. Omitting it is a compile error and runtime throw.
-- `cache` — `true` / `false` / `{ ttlMs }`. When enabled, `getDoc` / `getByIds` read from an LRU cache; writes invalidate it.
-- `trackable` — enables real-time `trackDoc` / `trackDocs` via change-stream NATS notifications.
-- `public` — allow unauthenticated client reads.
-- `cascadeFrom` — parent collection: when the parent doc is deleted, docs in this collection are cascade-deleted.
-- `trackKeys?` — fields usable as NATS routing keys for scoped `trackDocs` subscriptions.
-- `getter?(ids)` — batch resolver for collections with no local table (e.g. `userPublic` resolves via ugly.bot).
-- `skipReadValidation?` — opt out of per-row zod validation on reads for very hot collections. Writes are always validated. Global kill-switch: `UGLY_DB_VALIDATE_READS=0`.
-- `search?: { fields, language? }` — full-text index over the named JSONB paths (Neon: Postgres FTS; D1: SQLite FTS5, ranked by bm25).
-- `vector?: { dimensions, metric?, filterable? }` — ANN index. Vector supplied out-of-band at write time (`setDoc(c, doc, { vec })`) — never stored in the doc JSON. Query with `getDocs(c, filter, { near })`.
-
-All documents extend `DBObject`: `{ _id, version, created, updated }`.
-Use `dbDefaults()` to stamp `version` / `created` / `updated` on inserts.
-**Always generate `_id` with `nanoid()`** — never `crypto.randomUUID()`,
-`Date.now()`, or `Math.random()` (see `CLAUDE.md`).
-
-After schema changes, run `npm run db:schema-gen` then `npm run db:migrate`.
-The app refuses to start when drift is detected (set `SCHEMA_CHECK_SKIP=true`
-only as a last resort).
-
----
-
-## Routing
+## 2. Routing
 
 Route definitions live in `shared/pages.ts`; the client-side router is
 created by `createRouter({ pages, allPages?, ssrPages? })`.
 
-### `definePage` / `definePages` (`shared/pages.ts`)
+### `definePage` / `definePages`
 
 ```ts
 import { definePage, definePages } from 'ugly-app/shared';
@@ -452,10 +364,10 @@ virtualized lists with scroll-position persistence, use the richer
 
 ---
 
-## Client — `bootstrapApp()`
+## 3. Client — `bootstrapApp()` and `useApp()`
 
-The recommended entry point. Handles auth detection, socket creation,
-background account-sync with ugly.bot, and provider wiring.
+The recommended client entry point. Handles auth detection, socket
+creation, background account-sync with ugly.bot, and provider wiring.
 
 ```tsx
 // client/main.tsx
@@ -562,7 +474,7 @@ For pure HTTP (no WebSocket), use
 
 ---
 
-## Auth
+## 4. Auth flow
 
 ugly-app uses HttpOnly cookies and server-side JWT injection — no
 `localStorage`, no client-side token handling.
@@ -631,12 +543,91 @@ configurator.setAuth({
 
 ---
 
-## Database — `TypedDB`
+## 5. Database — `TypedDB`
 
 Access via `app.db`. All methods accept a `CollectionDef` (from
 `defineCollections()`) or, on the `raw*` / `getQuery*` variants, a plain
 collection name string.
 
+### Requests (`shared/api.ts`)
+
+```ts
+import { authReq, defineRequests, req, z } from 'ugly-app/shared';
+
+export const requests = defineRequests({
+  // Public — handler signature: (userId: string | null, input) => Promise<output>
+  getPublicData: req({
+    input: z.object({ id: z.string() }),
+    output: z.object({ data: z.string() }),
+  }),
+
+  // Authenticated — 401 enforced automatically, userId guaranteed string
+  getMe: authReq({
+    input: z.object({}),
+    output: z.object({ userId: z.string(), email: z.string().optional() }),
+  }),
+
+  // Per-endpoint rate limiting — enforced before the handler runs
+  submitFeedback: authReq({
+    input: z.object({ type: z.enum(['bug', 'design', 'feature']), message: z.string() }),
+    output: z.object({ id: z.string() }),
+    rateLimit: { max: 20, window: 60 },
+  }),
+});
+```
+
+Every request is reachable as **both** `socket.request(name, input)`
+(WebSocket) and `POST /api/:name { input }` (HTTP). `z` is re-exported from
+Zod for convenience.
+
+### Collections (`shared/collections.ts`)
+
+```ts
+import { defineCollections, InferDocType, neon } from 'ugly-app/shared';
+import { z } from 'zod';
+
+export const TodoSchema = z.object({
+  userId: z.string(),
+  text: z.string(),
+  done: z.boolean(),
+});
+export type Todo = InferDocType<typeof TodoSchema>;
+
+export const collections = defineCollections({
+  todo: {
+    schema: TodoSchema,
+    meta: {
+      db: neon,                // REQUIRED — `neon` (Postgres) or `d1` (SQLite / D1)
+      cache: true,             // or { ttlMs: 60_000 }
+      trackable: true,
+      public: false,
+      cascadeFrom: null,
+    },
+  },
+});
+```
+
+**`CollectionMeta`:**
+- `db` — **required.** `neon` (Postgres) or `d1` (Cloudflare D1 / SQLite). Both handles are exported from `ugly-app/shared`. Omitting it is a compile error and runtime throw.
+- `cache` — `true` / `false` / `{ ttlMs }`. When enabled, `getDoc` / `getByIds` read from an LRU cache; writes invalidate it.
+- `trackable` — enables real-time `trackDoc` / `trackDocs` via change-stream NATS notifications.
+- `public` — allow unauthenticated client reads.
+- `cascadeFrom` — parent collection: when the parent doc is deleted, docs in this collection are cascade-deleted.
+- `trackKeys?` — fields usable as NATS routing keys for scoped `trackDocs` subscriptions.
+- `getter?(ids)` — batch resolver for collections with no local table (e.g. `userPublic` resolves via ugly.bot).
+- `skipReadValidation?` — opt out of per-row zod validation on reads for very hot collections. Writes are always validated. Global kill-switch: `UGLY_DB_VALIDATE_READS=0`.
+- `search?: { fields, language? }` — full-text index over the named JSONB paths (Neon: Postgres FTS; D1: SQLite FTS5, ranked by bm25).
+- `vector?: { dimensions, metric?, filterable? }` — ANN index. Vector supplied out-of-band at write time (`setDoc(c, doc, { vec })`) — never stored in the doc JSON. Query with `getDocs(c, filter, { near })`.
+
+All documents extend `DBObject`: `{ _id, version, created, updated }`.
+Use `dbDefaults()` to stamp `version` / `created` / `updated` on inserts.
+**Always generate `_id` with `nanoid()`** — never `crypto.randomUUID()`,
+`Date.now()`, or `Math.random()` (see `CLAUDE.md`).
+
+After schema changes, run `npm run db:schema-gen` then `npm run db:migrate`.
+The app refuses to start when drift is detected (set `SCHEMA_CHECK_SKIP=true`
+only as a last resort).
+
 ### Writing
 
 ```ts
@@ -745,7 +736,7 @@ Imports available from `ugly-app`:
 
 ---
 
-## AI providers
+## 6. AI providers
 
 AI calls are proxied through ugly.bot — your app never holds a provider
 key. Pass `UGLY_BOT_TOKEN` in the environment and the framework handles
@@ -758,6 +749,7 @@ import { createTextGen } from 'ugly-app';
 const textGen = createTextGen(userId);
 
 const text = await textGen.generate(messages, { model: 'gemini_2_5_flash' });
+const obj  = await textGen.generateJson(mySchema, messages, { model: 'gemini_2_5_flash' });
 ```
 
 Or invoke the framework `textGen` request through the RPC pipeline — its
@@ -794,6 +786,7 @@ const url = await imageGen.generate('A red panda eating noodles', { model: 'flux
 import { createEmbeddingClient, cosineSimilarity } from 'ugly-app';
 const embeddings = createEmbeddingClient();
 const vector = await embeddings.embed('hello world');
+const many   = await embeddings.embedBatch(['a', 'b', 'c']);
 const sim    = cosineSimilarity(vectorA, vectorB);
 ```
 
@@ -838,9 +831,25 @@ const { speak, stop: stopTTS }                 = useTTS(uglyBotSocket);
 `uglyBotSocket` is the `UglyBotSocket` on `useApp()`; it opens a direct
 WebSocket to the platform.
 
+### Sharing / share links
+
+```ts
+import { shareLink } from 'ugly-app';   // server
+const url = await shareLink({
+  target: `/article/${id}`,             // app route or absolute URL
+  og: { title, description, image },    // OG card metadata
+  requireAuth: false,                   // true → logged-out web users hit login
+});                                     // → https://ugly.bot/l/<code>
+```
+
+Minting is idempotent (deterministic code) and dedupes within a run.
+Never hand-build outbound URLs (`${PUBLIC_URL}/article/${id}`) in emails,
+push, or share flows — always go through `shareLink()`. See the "sharing
+links" rule in `CLAUDE.md`.
+
 ---
 
-## Storage
+## 7. Storage
 
 S3-compatible. Two logical buckets:
 

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.988";
+export declare const CLI_VERSION = "0.1.990";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.988";
+export const CLI_VERSION = "0.1.990";
 //# sourceMappingURL=version.js.map

package/dist/client/components/Modal.d.ts

@@ -6,5 +6,15 @@ export interface ModalProps {
     'className'?: string;
     'data-id'?: string;
 }
+/**
+ * A centred, modal dialog.
+ *
+ * Built on the shared overlay tier, which is a behaviour change as well as a
+ * cosmetic one. It used to hardcode `bg-white dark:bg-gray-800` and so looked
+ * identical in every app regardless of theme; it now derives from the app's own
+ * tokens like every other surface. It also gains what it never had: focus
+ * return on close, a dismissal path that is not Escape-only, and the shared
+ * enter/exit transition.
+ */
 export declare function Modal({ title, children, onClose, className, 'data-id': dataId, }: ModalProps): ReactElement;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/client/components/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/client/components/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrE,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAc,EACd,SAAS,EAAE,MAAM,GAClB,EAAE,UAAU,GAAG,YAAY,CA8C3B"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/client/components/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKnE,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAc,EACd,SAAS,EAAE,MAAM,GAClB,EAAE,UAAU,GAAG,YAAY,CAmE3B"}

package/dist/client/components/Modal.js

@@ -1,19 +1,40 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect } from 'react';
-import { Z } from './zIndex.js';
+import { useMemo } from 'react';
+import { Overlay } from '../overlay/Overlay.js';
+import { Surface } from '../overlay/Surface.js';
+/**
+ * A centred, modal dialog.
+ *
+ * Built on the shared overlay tier, which is a behaviour change as well as a
+ * cosmetic one. It used to hardcode `bg-white dark:bg-gray-800` and so looked
+ * identical in every app regardless of theme; it now derives from the app's own
+ * tokens like every other surface. It also gains what it never had: focus
+ * return on close, a dismissal path that is not Escape-only, and the shared
+ * enter/exit transition.
+ */
 export function Modal({ title, children, onClose, className = '', 'data-id': dataId, }) {
-    // Close on Escape key
-    useEffect(() => {
-        const handler = (e) => {
-            if (e.key === 'Escape') {
-                onClose();
-            }
-        };
-        document.addEventListener('keydown', handler);
-        return () => {
-            document.removeEventListener('keydown', handler);
-        };
-    }, [onClose]);
-    return (_jsxs("div", { role: "dialog", "aria-modal": "true", "data-id": dataId, className: "fixed inset-0 flex items-center justify-center", style: { zIndex: Z.modal }, children: [_jsx("div", { className: "absolute inset-0 bg-black/50", onClick: onClose }), _jsxs("div", { className: `relative bg-white dark:bg-gray-800 rounded-lg shadow-xl max-w-lg w-full mx-4 max-h-[90vh] overflow-y-auto ${className}`, children: [title && (_jsxs("div", { className: "flex items-center justify-between p-4 border-b border-gray-200 dark:border-gray-700", children: [_jsx("h2", { className: "text-lg font-semibold text-gray-900 dark:text-gray-100", children: title }), _jsx("button", { onClick: onClose, "aria-label": "Close dialog", className: "text-gray-400 hover:text-gray-600 dark:hover:text-gray-200", children: "\u2715" })] })), _jsx("div", { className: "p-4", children: children })] })] }));
+    const anchor = useMemo(() => ({ kind: 'viewport' }), []);
+    return (_jsx(Overlay, { open: true, anchor: anchor, layer: "modal", modal: true, reposition: "follow", dismissOn: { outside: true, escape: true }, onDismiss: onClose, role: "dialog", ...(title ? { 'aria-label': title } : {}), ...(dataId ? { 'data-id': dataId } : {}), children: (pos) => (_jsx(Surface, { variant: "dialog", style: {
+                width: 'min(32rem, calc(100vw - 2rem))',
+                maxHeight: pos.available.height,
+                overflowY: 'auto',
+                padding: 0,
+            }, children: _jsxs("div", { className: className, children: [title ? (_jsxs("div", { style: {
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'space-between',
+                            gap: 12,
+                            padding: '14px 16px',
+                            borderBottom: '1px solid var(--app-border, rgba(0,0,0,.12))',
+                        }, children: [_jsx("h2", { style: { margin: 0, fontSize: 17, fontWeight: 600 }, children: title }), _jsx("button", { type: "button", onClick: onClose, "aria-label": "Close dialog", "data-id": "modal-close", style: {
+                                    border: 0,
+                                    background: 'none',
+                                    cursor: 'pointer',
+                                    color: 'inherit',
+                                    opacity: 0.6,
+                                    fontSize: 15,
+                                    lineHeight: 1,
+                                    padding: 4,
+                                }, children: "\u2715" })] })) : null, _jsx("div", { style: { padding: 16 }, children: children })] }) })) }));
 }
 //# sourceMappingURL=Modal.js.map

package/dist/client/components/Modal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../../src/client/components/Modal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAqC,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAC;AAUhC,MAAM,UAAU,KAAK,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GAAG,EAAE,EACd,SAAS,EAAE,MAAM,GACN;IACX,sBAAsB;IACtB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,EAAE;YACnC,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,CACL,eACE,IAAI,EAAC,QAAQ,gBACF,MAAM,aACR,MAAM,EACf,SAAS,EAAC,gDAAgD,EAC1D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,aAG1B,cAAK,SAAS,EAAC,8BAA8B,EAAC,OAAO,EAAE,OAAO,GAAI,EAElE,eACE,SAAS,EAAE,6GAA6G,SAAS,EAAE,aAElI,KAAK,IAAI,CACR,eAAK,SAAS,EAAC,qFAAqF,aAClG,aAAI,SAAS,EAAC,wDAAwD,YACnE,KAAK,GACH,EACL,iBACE,OAAO,EAAE,OAAO,gBACL,cAAc,EACzB,SAAS,EAAC,4DAA4D,uBAG/D,IACL,CACP,EACD,cAAK,SAAS,EAAC,KAAK,YAAE,QAAQ,GAAO,IACjC,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../../src/client/components/Modal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAqC,MAAM,OAAO,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWhD;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GAAG,EAAE,EACd,SAAS,EAAE,MAAM,GACN;IACX,MAAM,MAAM,GAAG,OAAO,CAAgB,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAExE,OAAO,CACL,KAAC,OAAO,IACN,IAAI,QACJ,MAAM,EAAE,MAAM,EACd,KAAK,EAAC,OAAO,EACb,KAAK,QACL,UAAU,EAAC,QAAQ,EACnB,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAC1C,SAAS,EAAE,OAAO,EAClB,IAAI,EAAC,QAAQ,KACT,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACtC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAExC,CAAC,GAAG,EAAE,EAAE,CAAC,CACR,KAAC,OAAO,IACN,OAAO,EAAC,QAAQ,EAChB,KAAK,EAAE;gBACL,KAAK,EAAE,gCAAgC;gBACvC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM;gBAC/B,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,CAAC;aACX,YAED,eAAK,SAAS,EAAE,SAAS,aACtB,KAAK,CAAC,CAAC,CAAC,CACP,eACE,KAAK,EAAE;4BACL,OAAO,EAAE,MAAM;4BACf,UAAU,EAAE,QAAQ;4BACpB,cAAc,EAAE,eAAe;4BAC/B,GAAG,EAAE,EAAE;4BACP,OAAO,EAAE,WAAW;4BACpB,YAAY,EAAE,8CAA8C;yBAC7D,aAED,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YACpD,KAAK,GACH,EACL,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,gBACL,cAAc,aACjB,aAAa,EACrB,KAAK,EAAE;oCACL,MAAM,EAAE,CAAC;oCACT,UAAU,EAAE,MAAM;oCAClB,MAAM,EAAE,SAAS;oCACjB,KAAK,EAAE,SAAS;oCAChB,OAAO,EAAE,GAAG;oCACZ,QAAQ,EAAE,EAAE;oCACZ,UAAU,EAAE,CAAC;oCACb,OAAO,EAAE,CAAC;iCACX,uBAGM,IACL,CACP,CAAC,CAAC,CAAC,IAAI,EACR,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAO,IACzC,GACE,CACX,GACO,CACX,CAAC;AACJ,CAAC"}

package/dist/client/components/PopupPanel.d.ts

@@ -5,5 +5,14 @@ export interface PopupPanelProps {
     dynamic?: boolean;
     style?: CSSProperties;
 }
+/**
+ * A raised panel for popup content.
+ *
+ * Now a `Surface`, so it shares the one shadow ramp and radius with every other
+ * overlay instead of carrying its own glassmorphic treatment — the divergence
+ * this library exists to end. It stays a plain box: it does no positioning and
+ * no dismissal, because its callers place it themselves inside
+ * `router.openPopup`.
+ */
 export declare function PopupPanel({ children, dynamic, style, }: PopupPanelProps): ReactElement;
 //# sourceMappingURL=PopupPanel.d.ts.map

package/dist/client/components/PopupPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PopupPanel.d.ts","sourceRoot":"","sources":["../../../src/client/components/PopupPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAe,EACf,KAAK,GACN,EAAE,eAAe,GAAG,YAAY,CAiBhC"}
+{"version":3,"file":"PopupPanel.d.ts","sourceRoot":"","sources":["../../../src/client/components/PopupPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAe,EACf,KAAK,GACN,EAAE,eAAe,GAAG,YAAY,CAShC"}

package/dist/client/components/PopupPanel.js

@@ -1,14 +1,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { Surface } from '../overlay/Surface.js';
+/**
+ * A raised panel for popup content.
+ *
+ * Now a `Surface`, so it shares the one shadow ramp and radius with every other
+ * overlay instead of carrying its own glassmorphic treatment — the divergence
+ * this library exists to end. It stays a plain box: it does no positioning and
+ * no dismissal, because its callers place it themselves inside
+ * `router.openPopup`.
+ */
 export function PopupPanel({ children, dynamic = false, style, }) {
-    return (_jsx("div", { style: {
-            borderRadius: 16,
-            background: 'var(--app-main, #fff)',
-            backdropFilter: 'blur(12px)',
-            WebkitBackdropFilter: 'blur(12px)',
-            border: '1px solid rgba(255,255,255,0.2)',
-            boxShadow: '0 20px 25px rgba(0,0,0,0.15)',
-            flex: dynamic ? undefined : 1,
-            ...style,
-        }, children: children }));
+    return (_jsx(Surface, { variant: "sheet", style: { flex: dynamic ? undefined : 1, ...style }, children: children }));
 }
 //# sourceMappingURL=PopupPanel.js.map

package/dist/client/components/PopupPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"PopupPanel.js","sourceRoot":"","sources":["../../../src/client/components/PopupPanel.tsx"],"names":[],"mappings":";AASA,MAAM,UAAU,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,GAAG,KAAK,EACf,KAAK,GACW;IAChB,OAAO,CACL,cACE,KAAK,EAAE;YACL,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,uBAAuB;YACnC,cAAc,EAAE,YAAY;YAC5B,oBAAoB,EAAE,YAAY;YAClC,MAAM,EAAE,iCAAiC;YACzC,SAAS,EAAE,8BAA8B;YACzC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7B,GAAG,KAAK;SACT,YAEA,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"PopupPanel.js","sourceRoot":"","sources":["../../../src/client/components/PopupPanel.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAShD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,GAAG,KAAK,EACf,KAAK,GACW;IAChB,OAAO,CACL,KAAC,OAAO,IACN,OAAO,EAAC,OAAO,EACf,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,YAEjD,QAAQ,GACD,CACX,CAAC;AACJ,CAAC"}

package/dist/client/index.d.ts

@@ -44,6 +44,7 @@ export { uploadBlob, promoteBlob, downscaleImage } from './uploadBlob.js';
 export { crossOriginProps } from './components/crossOriginProps.js';
 export type { UploadedBlob, UploadBlobOptions } from './uploadBlob.js';
 export * from './components/index.js';
+export * from './overlay/index.js';
 export { createHttpClient } from './createHttpClient.js';
 export type { AppHttpClient, CreateHttpClientOptions, } from './createHttpClient.js';
 export { createSocket } from './createSocket.js';

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -30,6 +30,8 @@ export { uploadBlob, promoteBlob, downscaleImage } from './uploadBlob.js';
 // see components/crossOriginProps.ts.
 export { crossOriginProps } from './components/crossOriginProps.js';
 export * from './components/index.js';
+// Overlay controls — tooltips, dropdowns, context menus, popovers.
+export * from './overlay/index.js';
 export { createHttpClient } from './createHttpClient.js';
 export { createSocket } from './createSocket.js';
 export { shareLink } from './shareLinkClient.js';

package/dist/client/index.js.map

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

package/dist/client/overlay/Menu.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Menu — the node model rendered.
+ *
+ * Handles both layouts, because they are the same thing turned on its side: a
+ * stacked menu (ugly.bot's app menu, a right-click menu) and an inline one (the
+ * markdown editor's selection toolbar). Sharing the renderer is what keeps
+ * their theming, dismissal and keyboard behaviour identical, but a few things
+ * MUST differ by layout — see `Separator`, `checked` and the width bound.
+ */
+import { type ReactElement } from 'react';
+import { useSurfaceTokens } from './Surface.js';
+import { useOverlayDefaults } from './OverlayProvider.js';
+import type { DismissReason, MenuAction, MenuNode, MenuProps } from './types.js';
+export declare const isSeparator: (n: MenuNode) => n is {
+    separator: true;
+};
+export declare const isHeading: (n: MenuNode) => n is Extract<MenuNode, {
+    heading: true;
+}>;
+export declare const isGroup: (n: MenuNode) => n is Extract<MenuNode, {
+    group: true;
+}>;
+export declare const isCustom: (n: MenuNode) => n is Extract<MenuNode, {
+    render: unknown;
+}>;
+export declare const isAction: (n: MenuNode) => n is MenuAction;
+export declare function Menu(props: MenuProps): ReactElement | null;
+export type { DismissReason };
+export { useSurfaceTokens, useOverlayDefaults };
+//# sourceMappingURL=Menu.d.ts.map

package/dist/client/overlay/Menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../src/client/overlay/Menu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAQL,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAW,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,EAGV,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,WAAW,GAAI,GAAG,QAAQ,KAAG,CAAC,IAAI;IAAE,SAAS,EAAE,IAAI,CAAA;CAC9C,CAAC;AACnB,eAAO,MAAM,SAAS,GACpB,GAAG,QAAQ,KACV,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAmB,CAAC;AAC/D,eAAO,MAAM,OAAO,GAAI,GAAG,QAAQ,KAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAC9D,CAAC;AACf,eAAO,MAAM,QAAQ,GACnB,GAAG,QAAQ,KACV,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAkB,CAAC;AAChE,eAAO,MAAM,QAAQ,GAAI,GAAG,QAAQ,KAAG,CAAC,IAAI,UACqB,CAAC;AA4gBlE,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CA2E1D;AAED,YAAY,EAAE,aAAa,EAAE,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC"}