@toa.io/extensions.configuration 1.0.0-alpha.274 → 1.0.0-alpha.276

package/ui/.agents/skills/antcn/references/hold.md

@@ -1,34 +0,0 @@
-# Hold
-
-`Alt`+click fires `onclick` immediately (power users / tests). Right-click is swallowed.
-
-Use a unique `name` per instance when several holds share a page (CSS anchor). Set `portal={false}` inside transformed ancestors — Safari CSS anchor positioning quirk.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Hold } from '$com/hold'
-</script>
-
-<Hold label="hold to log out" onclick={() => signOut()}>
-  Log out
-</Hold>
-```
-
-## Props
-
-| Prop       | Type                                              | Default   | Notes                                                                        |
-| ---------- | ------------------------------------------------- | --------- | ---------------------------------------------------------------------------- |
-| `name`     | `string`                                          | `'hold'`  | CSS anchor name. Use a unique value per instance if multiple on one page.    |
-| `duration` | `number` (ms)                                     | `800`     | How long the user must hold before `onclick` fires.                          |
-| `label`    | `string`                                          | —         | Hint text shown in the tooltip while held. Use `message` snippet for richer markup. |
-| `message`  | `Snippet`                                         | —         | Overrides `label` for non-string content.                                    |
-| `position` | `'center' \| 'left' \| 'right' \| 'top' \| 'bottom'` | `'left'`  | Tooltip side (CSS anchor `position-area` first axis).                        |
-| `align`    | `'center' \| 'left' \| 'right' \| 'top' \| 'bottom'` | `'center'` | Tooltip alignment along the chosen side.                                     |
-| `portal`   | `boolean`                                         | `true`    | Teleport tooltip to `body`. Set `false` inside transformed ancestors (Safari anchor quirk). |
-| `onpress`  | `() => void`                                      | —         | Fires when the hold starts.                                                  |
-| `onclick`  | `() => void`                                      | —         | Fires after the full duration is held, or immediately on `Alt`+click.        |
-| `variant`  | `ButtonVariant`                                   | `'ghost'` | Forwarded to shadcn `Button`.                                                |
-
-All other props pass through to the underlying `Button`.

package/ui/.agents/skills/antcn/references/iam.md

@@ -1,117 +0,0 @@
-# iam
-
-Identity & access — a complete authentication surface plus the services behind it. UI covers passkey, password, one-time-passcode, and OIDC (Google/Apple) sign-in/sign-up, an `Authenticated` gate, an `Authorized` conditional-render guard, and session refresh on expiry. Services expose the `account` store, `logout`, `update`, `named`, and the `basic` / `otp` / `passkeys` / `oidc` flows.
-
-## `$config`
-
-| Field              | Type                | Notes                                                |
-| ------------------ | ------------------- | ---------------------------------------------------- |
-| `navigation.entry` | `{ entry: string }` | Route to land on after a successful OIDC redirect.   |
-
-Network access (`origin`, `sleep`) flows through `@/net`.
-
-## Environment
-
-OIDC client IDs come from `$env/dynamic/public`. Omit or leave empty to hide the provider button:
-
-| Var                       | Notes                                              |
-| ------------------------- | -------------------------------------------------- |
-| `PUBLIC_GOOGLE_CLIENT_ID` | Google OIDC client ID. Empty hides the Google button. |
-| `PUBLIC_APPLE_CLIENT_ID`  | Apple OIDC client ID. Empty hides the Apple button.  |
-
-## Notes
-
-- **OIDC is opt-in.** Missing/empty `PUBLIC_*_CLIENT_ID` disables the provider buttons — no wiring crashes if you only want password/passkey/OTP.
-- **Account shape.** Components accept an `AccountLike` (`Pick` of the account fields they render); the `account` store holds the authenticated `Echo`. Extend `Echo` (`svc/net/Echo.ts`) if your API returns extra profile fields.
-- **`Credentials` manager.** Renders the signed-in account's security surface: a passkey manager (register / list / hold-to-delete — a thin layer over `@/passkeys`), inert provider rows (email/Google/Apple; the `Connect` CTA carries no behaviour yet), and a "sign in on another device" action whose QR encodes the current session `challenge`. It gates itself on the `account` store, so just mount it anywhere inside your authenticated area.
-- **Session transfer is two-sided.** The QR is the *sending* device; the *receiving* device adopts the session by reading the fragment `challenge` on load. `rc()` already does this on init (shared `consume()`), so transfer completes as long as `rc()` runs once at app start.
-
-## Usage
-
-Gate an app behind authentication (`Authenticated` shows the auth surface until signed in, then renders its children):
-
-```svelte
-<script lang="ts">
-  import { Authenticated } from '@/iam/ui'
-</script>
-
-<Authenticated>
-  <Dashboard />
-</Authenticated>
-```
-
-Conditionally render UI with `Authorized`. It renders its children only when **at least one** passed check passes: `dev` (matches `$app/environment` `dev`), `beta` (host starts with `beta.`), `debug` (`dev` or `beta`), or `role` (scoped match against the account's `roles` — `app` matches `app`, `app:codes`, and deeper; `app:codes` matches only `app:codes` and deeper). No matching check → nothing renders.
-
-```svelte
-<script lang="ts">
-  import { Authorized } from '@/iam/ui'
-</script>
-
-<Authorized role="admin">
-  <AdminPanel />
-</Authorized>
-
-<Authorized dev>
-  <DebugToolbar />
-</Authorized>
-```
-
-Read the session reactively and sign out. `account` is a `svas` store of the authenticated `Echo` (`null` when signed out):
-
-```svelte
-<script lang="ts">
-  import { account, logout } from '@/iam'
-  import { goto } from '$app/navigation'
-
-  async function getout() {
-    logout()
-    void goto('/')
-  }
-</script>
-
-{#if $account}
-  <p>Signed in as {$account.name}</p>
-  <button onclick={getout}>Log out</button>
-{/if}
-```
-
-Block an action until the account has a display name — `named()` resolves once `account.name` is set (prompting through the auth surface if missing), so guarded flows can `await` it:
-
-```ts
-import { having } from 'svas'
-import { account, named } from '@/iam'
-
-async function onaccept() {
-  await having(account) // wait for a session
-  await named() // …and a chosen name
-  await invitations.accept(id)
-}
-```
-
-Patch the local session optimistically (e.g. after a profile edit) — `update` merges a partial into the `account` store without a round-trip:
-
-```ts
-import { update } from '@/iam'
-
-update({ name: 'Ada Lovelace' })
-```
-
-Gate non-UI logic on the `authenticated` derived boolean (true only when a challenge + account exist and nothing is processing):
-
-```ts
-import { authenticated } from '@/iam'
-
-authenticated.subscribe((ok) => ok && sync())
-```
-
-Render the account's credentials manager inside an authenticated area (passkeys, connected providers, device transfer). It only renders once a session exists, so no extra gating is needed:
-
-```svelte
-<script lang="ts">
-  import { Credentials } from '@/iam/ui'
-</script>
-
-<Credentials />
-```
-
-`Credentials` takes a single optional `class` (`ClassValue`) — everything else is driven by the `account` and `@/passkeys` stores.

package/ui/.agents/skills/antcn/references/input-form.md

@@ -1,34 +0,0 @@
-# InputForm
-
-Centered text field in a form that submits on blur when the value changed, or on Enter. Empty blur resets to the initial value. `onsubmit` may return a new string to sync the field after save.
-
-## Notes
-
-Exposes an imperative `focus()` method — bind the instance (`bind:this`) and call it to move focus to the field (e.g. when revealing the form).
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { InputForm } from '$com/input-form'
-
-  let name = $state('Alex')
-</script>
-
-<InputForm
-  value={name}
-  onsubmit={async (value) => {
-    name = value
-    return value
-  }}
-/>
-```
-
-## Props
-
-| Prop       | Type                                                              | Default | Notes                                              |
-| ---------- | ----------------------------------------------------------------- | ------- | -------------------------------------------------- |
-| `value`       | `string`                                                          | —             | Initial/current value; resets to this when cleared. |
-| `class`       | `ClassValue`                                                      | —             | Extra classes on the shadcn `Input`.               |
-| `placeholder` | `string`                                                          | `'Enter name'`| Placeholder text when the field is empty.          |
-| `onsubmit`    | `(value: string) => Promise<string \| undefined> \| string \| undefined` | —       | Called on blur (if changed) or form submit. Return a string to update the field. |

package/ui/.agents/skills/antcn/references/locale.md

@@ -1,66 +0,0 @@
-# locale
-
-Locale switching over the host svintl store. Two interchangeable switchers — `Languages` (snap-scroller) and `Language` (`Select` dropdown) — both set the active locale and fire `onselect` for persistence.
-
-## Languages
-
-Horizontal snap-scroller of native language names.
-
-### Usage
-
-```svelte
-<script lang="ts">
-  import { Languages } from '@/locale/ui'
-</script>
-
-<Languages />
-```
-
-`onselect` fires after the store updates — use it for side effects like persistence:
-
-```svelte
-<script lang="ts">
-  import { Languages } from '@/locale/ui'
-  import { me } from '@/accounts'
-  import type { Locale } from '$lib/intl'
-
-  function persist(locale: Locale) {
-    void me.update({ locale })
-  }
-</script>
-
-<Languages onselect={persist} />
-```
-
-### Props
-
-| Prop       | Type                       | Default | Notes                                                                                       |
-| ---------- | -------------------------- | ------- | ------------------------------------------------------------------------------------------- |
-| `onselect` | `(locale: Locale) => void` | —       | Fires after the host store is set. Use it to persist or track the choice.                   |
-| `infinite` | `boolean`                  | _auto_  | Forces the loop/clone scroller on or off. Defaults to on when `locales.length >= 10`.       |
-
-### Notes
-
-The active locale stays centered in the track. A long set (`>= 10`) loops endlessly; a short one renders once and centers via 50% gutters — dead-center whether it underfills or overflows. Centering is relative to the track's own width, so wrap it in a narrower box to constrain the window. `infinite` overrides the auto choice.
-
-## Language
-
-Compact `Select` for a settings row.
-
-### Usage
-
-```svelte
-<script lang="ts">
-  import { Language } from '@/locale/ui'
-  import { me } from '@/accounts'
-  import type { Locale } from '$lib/intl'
-</script>
-
-<Language onselect={(l: Locale) => me.update({ locale: l })} />
-```
-
-### Props
-
-| Prop       | Type                       | Default | Notes                                                                     |
-| ---------- | -------------------------- | ------- | ------------------------------------------------------------------------- |
-| `onselect` | `(locale: Locale) => void` | —       | Fires after the host store is set. Use it to persist or track the choice. |

package/ui/.agents/skills/antcn/references/net.md

@@ -1,33 +0,0 @@
-# net
-
-The networking foundation every other Solution builds on. Connects a single `@toa.io/origin` client to your API and re-exports it as `origin`, plus the `query` helper for building criteria query strings. Sibling Solutions import `origin` from `@/net` to declare their resources.
-
-## `$config`
-
-`net` reads two fields from your `$config` module (`import * as config from '$config'`):
-
-| Field    | Type                            | Notes                                                                       |
-| -------- | ------------------------------- | --------------------------------------------------------------------------- |
-| `origin` | `string`                        | Absolute API origin; `''` is invalid (resolved via `new URL(path, origin)`). |
-| `sleep`  | `[number, number] \| undefined` | Dev-only artificial latency range; `undefined` disables it.                 |
-
-## Usage
-
-Declare a resource against the shared client and call it:
-
-```ts
-import { origin, query, type RequestOptions } from '@/net'
-
-const echo = origin.resource<{ message: string }>('/accounts/echo/')
-
-async function ping(): Promise<{ message: string } | Error> {
-  return echo.json({ method: 'GET' } satisfies RequestOptions)
-}
-```
-
-`query` turns a `URLSearchParams` into a criteria string; `omit`/`limit`/`search` stay as plain pairs, everything else becomes `criteria=key==value;…`:
-
-```ts
-const params = new URLSearchParams({ status: 'active', limit: '20' })
-query(params) // '?criteria=status==active&limit=20'
-```

package/ui/.agents/skills/antcn/references/panel.md

@@ -1,44 +0,0 @@
-# Panel
-
-List row built on shadcn `Button`: main content in `left`/`right`/`icon` snippets, optional swipe-reveal `actions` on the trailing edge. Set `h` (e.g. `h-14`) when using `collapsed` — height animates to zero. Pass `selected` for accent ring styling (from `globals`).
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Panel, type Action } from '$com/panel'
-
-  const actions: Action[] = [{ id: 'delete', onclick: () => remove() }]
-</script>
-
-<Panel h="h-14" class="bg-card border border-border" href="/items/1">
-  {#snippet left()}
-    <span class="font-medium">Item title</span>
-  {/snippet}
-  {#snippet right()}
-    <span class="text-muted-foreground">$12</span>
-  {/snippet}
-  {#snippet action(id)}
-    {#if id === 'delete'}Delete{/if}
-  {/snippet}
-  {actions}
-</Panel>
-```
-
-## Props
-
-| Prop        | Type                         | Default     | Notes                                                                 |
-| ----------- | ---------------------------- | ----------- | --------------------------------------------------------------------- |
-| `left`      | `Snippet`                    | —           | Main label/content (required).                                        |
-| `right`     | `Snippet`                    | —           | Trailing slot (balance, badge, etc.).                                 |
-| `icon`      | `Snippet`                    | —           | Leading icon/avatar before `left`.                                    |
-| `collapsed` | `boolean`                    | `false`     | Animate height to zero. Requires `h`.                                 |
-| `selected`  | `boolean`                    | `false`     | Applies `.selected` ring styling.                                     |
-| `h`         | `string`                     | —           | Tailwind height class on the row and collapse wrapper.                |
-| `actions`   | `Action[]`                   | —           | Swipe-reveal toolbar items. Pair with `action` snippet.               |
-| `action`    | `Snippet<[string]>`          | —           | Renders one action by `id`. Required when `actions` is set.           |
-| `variant`   | `ButtonVariant`              | `'outline'` | Forwarded to shadcn `Button`.                                         |
-
-`Action`: `{ id, class?: ClassValue, href?, onclick? }` — tapping an action scrolls the row back; `href` navigates via SvelteKit `goto`.
-
-All other props pass through to the underlying `Button` (`href`, `onclick`, `class`, etc.).

package/ui/.agents/skills/antcn/references/passkeys.md

@@ -1,27 +0,0 @@
-# passkeys
-
-WebAuthn credential management — registers, lists, and removes passkeys for the signed-in account against your `/identity/passkeys` API. Wraps the browser `navigator.credentials` ceremony (challenge → `create`/`get` → attestation) so callers work with plain async operations that return values or `Error`.
-
-## Notes
-
-- **Requires `@/iam`.** The `passkeys` store keys credentials by the current `@/iam` `account`; `get`/`remove`/`store` all read it. No signed-in account → empty store. `iam` is **not** pulled automatically (that would form an install cycle — `iam` already depends on `passkeys`), so install it yourself: `npx shadcn-svelte add http://cn.ants.dev/r/iam.json`. Installing `iam` brings `passkeys` along, so most consumers never add `passkeys` directly.
-- **Feature detection.** `supported` is a boolean (`window.PublicKeyCredential !== undefined`, `true` on the server). Gate registration UI on it — the ceremony rejects on unsupported browsers.
-- **`ui/aaguid.json`** ships the FIDO AAGUID → authenticator-metadata map (name + light/dark icon, base64 SVG). Look up `aaguid[credential.aaguid]` to label a passkey by its authenticator (e.g. "Google Password Manager", "iCloud Keychain"). Optional — nothing imports it for you.
-
-## Usage
-
-```ts
-import { supported, add, request, remove, passkeys } from '@/passkeys'
-
-if (supported) {
-  const out = await add(identity, name) // full register: ceremony → POST → store
-  if (out instanceof Error) handle(out)
-}
-
-// reactive list for the current account
-passkeys.subscribe((list) => render(list))
-
-await remove(id) // revoke one
-```
-
-`request(id?)` runs the authentication (login) ceremony and returns the assertion (`RequestResponse`) for your auth flow to exchange. `create(name, identity?)` is the lower-level ceremony `add` builds on.

package/ui/.agents/skills/antcn/references/payments.md

@@ -1,99 +0,0 @@
-# payments
-
-Subscription paywall stack: a tier selector, animated benefits table, pay button, platform-mandated legal disclaimers, and a processing overlay, backed by four payment processors (App Store, Google Play, Stripe, a dev mock) behind one `Processor` interface. Ships a neutral SaaS example (Storage / Seats / Priority / API) you adapt to your product.
-
-## `$config`
-
-| Field    | Used by                                                                                   |
-| -------- | ----------------------------------------------------------------------------------------- |
-| `origin` | All three live processors resolve their backend endpoints through `@/net`'s `origin`, which reads `$config.origin`. |
-
-The App Store / Google Play processors transact through the native shell (`@/bridge`); the dev processor stands in whenever `$app/environment`'s `dev` is true and there is no native host. No other `$config` field is read.
-
-## Entitlements
-
-`tier` is the only entitlement the shipped UI reads. Everything else in `Entitlements` is a neutral example you replace with your product's metered (`number`) and flag (`boolean`) entitlements — edit the interface in `svc/entitlements.ts`:
-
-```ts
-export interface Entitlements {
-  tier: Tier
-  seats: number      // metered → gated by usage(account, 'seats') >= seats
-  storage: number    // metered
-  priority: boolean  // flag → gated by the boolean itself
-}
-```
-
-`cant(account, key?)` gates generically off the value type — no per-key `switch`:
-
-- no `key` → `true` unless the account has unexpired premium.
-- `boolean` entitlement → `true` when the flag is off.
-- `number` entitlement → `true` when summed usage (`account.usage`) has reached the limit.
-- anything else (e.g. the `tier` string) → never gated.
-
-`usages()` (the `Entitlements` UI) derives one usage bar per **numeric** entitlement automatically, so adding/removing a metered key needs no UI change. When you rename a key, add a matching `used.<key>` and `benefits.<key>` entry to the intl mount.
-
-The account shape is `AccountLike` (`id`, optional `premium`, `processor`, `interval`, `entitlements`, `usage`) — a structural subset of your identity account; pass your `@/iam` account (or any object satisfying it) to `cant`/`usages`/the UI. `interval` is the account's current billing period as an ISO-8601 duration (`P1M`/`P1Y`); the paywall reads it to preselect the matching interval tab.
-
-## Tiers
-
-The upgrade ladder is `tiers = ['basic', 'premium', 'expert']` in `svc/tier.ts` (`rank()` orders upgrades off it). Override it by editing that array in place — there is no config hook. Keep the `tier` values, the `Entitlements.tier` type, the `groups`/`plans` intl keys, and your store product groups in sync with it.
-
-## Notes
-
-- **Products come from the store, not this Solution.** Each processor fetches its own catalog: App Store / Google Play via the native bridge over a fixed set of product IDs (`<tier>_<month|year>`, edit the `IDS` array per processor), Stripe via `GET /stripe/checkout/products`. The dev processor serves the static `svc/processors/dev/products.ts` list so the paywall renders with no backend. Align your store product IDs / Stripe price `metadata.tier` with your `tiers`.
-- **Backend endpoints.** Live processors call, under `$config.origin`: `POST/PATCH /appstore/transactions/{id}`, `POST /googleplay/transactions/{id}`, `GET /stripe/checkout/products`, `POST /stripe/checkout/{id}` (+ `/{id}/portal`), `POST /stripe/transactions/{id}`. You implement these.
-- **Stripe return.** Stripe checkout redirects back to `#stripe={CHECKOUT_SESSION_ID}`; `rc()` reads that one-shot hash through `@/fragments` and commits the transaction behind the processing overlay. Call `rc()` once on app start.
-- **Google Play package id.** `svc/processors/googleplay/processor.ts` builds the manage-subscription URL from a placeholder `com.example.twa` — replace it with your Trusted Web Activity package id (the same one you set in `@/bridge`).
-- **Analytics.** The processors emit `checkout` / `purchase` events through `@/analytics`; `Payguard` emits `paywall`. `analytics.d.ts` augments the analytics `Events` interface with the `paywall` / `checkout` shapes.
-- **Legal copy & links.** The disclaimers are neutral, store-compliant defaults; `Legal.svelte` links to `/terms/` and `/privacy/` — point them at your pages. Ships its own svintl mount in the registry's four locales; after install reconcile it: `npx intl import payments src/@/payments/ui/intl`.
-
-## Usage
-
-Commit a pending Stripe return once on app start, then drop the paywall behind anything that needs premium:
-
-```svelte
-<script lang="ts">
-  import { onMount } from 'svelte'
-  import { rc } from '@/payments/rc'
-  import { Payguard, Entitlements } from '@/payments/ui'
-  import { Button } from '$ui/button'
-  import { account } from '@/iam'
-
-  onMount(rc)
-</script>
-
-<!-- gates the action: opens the paywall when the account can't use `seats` -->
-<Payguard entitlement="seats">
-  <Button>Invite a teammate</Button>
-</Payguard>
-
-{#if $account}
-  <Entitlements account={$account} />
-{/if}
-```
-
-`<Paywall>` is the full-screen plan picker `<Payguard>` opens; mount it directly when you want a standalone pricing page.
-
-## Props
-
-### `Payguard`
-
-| Prop          | Type                   | Default | Notes                                                                       |
-| ------------- | ---------------------- | ------- | --------------------------------------------------------------------------- |
-| `children`    | `Snippet`              | —       | The gated trigger; rendered as-is when the account already has entitlement. |
-| `entitlement` | `keyof Entitlements`   | —       | When set, gates on that specific entitlement; omit to gate on premium only. |
-| `crown`       | `boolean`              | `true`  | Show the crown badge on the gated trigger.                                  |
-| `class`       | `ClassValue`           | —       | Forwarded to the trigger button.                                            |
-
-### `Paywall`
-
-| Prop         | Type         | Default | Notes                                  |
-| ------------ | ------------ | ------- | -------------------------------------- |
-| `oncomplete` | `() => void` | —       | Fired after a successful checkout or dismissal. |
-
-### `Entitlements`
-
-| Prop      | Type          | Default | Notes                                                  |
-| --------- | ------------- | ------- | ------------------------------------------------------ |
-| `account` | `AccountLike` | —       | Renders the current plan, usage bars, and manage/upgrade action. |
-| `class`   | `ClassValue`  | —       | Root class.                                            |

package/ui/.agents/skills/antcn/references/realtime.md

@@ -1,69 +0,0 @@
-# realtime
-
-Server-pushed event stream layered on `@toa.io/origin` multipart. `connect(id)` opens a long-running multipart POST to `/presence/{id}/`, parses each chunk into a typed event, and re-emits it on a `mitt` bus. `rc()` ties the connection lifecycle to `@/iam`'s `authenticated` derived: connects with the current account id on sign-in, disconnects on sign-out, reconnects automatically on errors. Exposes a `dashboard` store (`status` + last 128 events), a `time` store (server clock — updated from `origin` response `Date` headers), and the `events` emitter for domain modules to subscribe to.
-
-## Wiring
-
-Both `@/iam` and `@/realtime` install `rc()` bootstraps that must run once in the browser. Call them from the root `+layout.ts`:
-
-```ts
-import { rc as iam } from '@/iam/rc'
-import { rc as realtime } from '@/realtime/rc'
-import { browser } from '$app/environment'
-
-if (browser) {
-  iam()
-  realtime()
-}
-```
-
-## Domain events
-
-`svc/events.ts` declares `Events = Record<string, unknown> // add domain events here`. Extend it per domain so the emitter is typed end-to-end. Convention: every domain that publishes server events exposes an `Events` type from `@/<domain>/svc/net` and the host intersects them:
-
-```ts
-// src/@/realtime/svc/events.ts (edit after install)
-import type { Events as Contacts } from '@/contacts/svc/net'
-import type { Events as Notifications } from '@/notifications/svc/net'
-
-export type Events = Contacts & Notifications
-```
-
-Subscribe in any domain's store:
-
-```ts
-import { events } from '@/realtime'
-
-events.on('contact.added', (data) => { /* … */ })
-```
-
-## Notes
-
-- **Backend contract.** `/presence/{id}/` must return `multipart/mixed` per `@toa.io/origin` multipart: first part `"ACK"`, then JSON parts of shape `{ event, data }` or the literal string `"heartbeat"`, terminated by `"FIN"`. The Solution forces `credentials: 'include'` and sends `{ timezone }` in the body.
-- **Auto-reconnect.** Errors other than `AbortError` retry after 3 s. `disconnect()` (or sign-out via `rc()`) aborts the in-flight request.
-- **`time` store.** Seeded with `Date.now()` and updated on every `origin` response — handy for clock skew correction in UI relative timestamps.
-
-## Usage
-
-Read connection status and the last events for a debug panel:
-
-```svelte
-<script lang="ts">
-  import { dashboard } from '@/realtime'
-</script>
-
-<p>Status: {$dashboard.status}</p>
-<ul>
-  {#each $dashboard.events as e (e)}
-    <li>{e.label}: {JSON.stringify(e.payload)}</li>
-  {/each}
-</ul>
-```
-
-Subscribe to a typed event:
-
-```ts
-import { events } from '@/realtime'
-
-events.on('heartbeat', () => console.debug('alive'))
-```

package/ui/.agents/skills/antcn/references/scrollable.md

@@ -1,39 +0,0 @@
-# Scrollable
-
-Horizontal snap scroller with optional infinite loop and programmatic scroll-to-index. Give each child `snap-center` or `snap-start` (and fixed width) for predictable snapping.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Scrollable } from '$com/scrollable'
-
-  let index = $state(0)
-  const items = ['One', 'Two', 'Three']
-</script>
-
-<Scrollable scroll={index} class="gap-2">
-  {#each items as item, i (item)}
-    <button class="snap-center shrink-0 rounded-lg border px-4 py-2" onclick={() => (index = i)}>
-      {item}
-    </button>
-  {/each}
-</Scrollable>
-```
-
-## Props
-
-| Prop         | Type                     | Default   | Notes                                                                 |
-| ------------ | ------------------------ | --------- | --------------------------------------------------------------------- |
-| `children`   | `Snippet`                | —         | Scroll items. Duplicated internally when `infinite` is true.          |
-| `infinite`   | `boolean`                | `false`   | Loop by cloning children; recenters on `scrollend`.                   |
-| `align`      | `'start' \| 'center'`    | `'start'` | How `scroll` index is positioned.                                     |
-| `scroll`     | `number`                 | `0`       | Child index to scroll to. Use `-1` to skip initial scroll.            |
-| `bleed`      | `boolean`                | `false`   | Break out to full viewport width (edge-to-edge carousel).             |
-| `gutter`     | `boolean`                | `false`   | Half-track end gutters so the first/last item can sit dead-center. Pairs with `align="center"`; ignored when `infinite`. |
-| `controlled` | `boolean`                | `false`   | Hide native overflow; drive scroll externally.                        |
-| `dir`        | `'ltr' \| 'rtl'`         | —         | Direction on the outer container.                                     |
-| `class`      | `ClassValue`             | —         | Classes on the scroll track (gap, padding, etc.).                     |
-| `style`      | `string`                 | —         | Inline style on the outer container.                                  |
-| `id`         | `string`                 | —         | Id on the scroll track.                                               |
-| `onscroll`   | `(e: Event) => void`     | —         | Scroll handler on the track.                                        |

package/ui/.agents/skills/antcn/references/selector.md

@@ -1,71 +0,0 @@
-# Selector
-
-Card-style option list for single- or multi-choice selection. Import as a namespace (`import * as Selector from '$com/selector'`).
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import * as Selector from '$com/selector'
-
-  let value = $state('')
-  let values = $state<string[]>([])
-</script>
-
-<Selector.Root bind:value>
-  <Selector.Option value="yearly">
-    <Selector.Title>
-      <strong>Yearly</strong>
-      129,99€ per year
-    </Selector.Title>
-    <Selector.Description>32€ monthly</Selector.Description>
-  </Selector.Option>
-  <Selector.Option value="monthly">
-    <Selector.Title>
-      <strong>Monthly</strong>
-      29,99€ per month
-    </Selector.Title>
-    <Selector.Description>Flexible, slightly pricier</Selector.Description>
-  </Selector.Option>
-</Selector.Root>
-
-<Selector.Root bind:values type="multi" position="end">
-  <Selector.Option value="notifications">
-    <Selector.Title>Notifications</Selector.Title>
-    <Selector.Description>Email and push alerts</Selector.Description>
-  </Selector.Option>
-</Selector.Root>
-```
-
-## Notes
-
-More than one `Selector.Root` on the same page with overlapping option `value`s needs a unique `id` on each root (e.g. `id="billing"` / `id="addons"`).
-
-## Props
-
-### Root
-
-| Prop       | Type                  | Default   | Notes                                              |
-| ---------- | --------------------- | --------- | -------------------------------------------------- |
-| `id`       | `string`              | `'radio'` | Prefix for each option’s control/label id.         |
-| `type`     | `'single' \| 'multi'` | `'single'`| Single uses radio group; multi uses checkboxes.    |
-| `value`    | `string`              | `''`      | Bindable selection for `type="single"`.            |
-| `values`   | `string[]`            | `[]`      | Bindable selection for `type="multi"`.             |
-| `position` | `'start' \| 'end'`    | `'start'` | Indicator column: leading media or trailing actions. |
-| `variant`  | `ItemVariant`         | `'outline'` | Forwarded to each `Option` row.                  |
-| `size`     | `ItemSize`            | —         | Forwarded to each `Option` row.                    |
-| `class`    | `ClassValue`              | —         | Wrapper classes (`single` mode radio group only).  |
-| `children` | `Snippet`             | —         | `Option` slots.                                    |
-
-### Option
-
-| Prop       | Type      | Default | Notes                                      |
-| ---------- | --------- | ------- | ------------------------------------------ |
-| `value`    | `string`  | —       | Option id stored in `value` / `values`.    |
-| `id`       | `string`  | `{rootId}-{value}` | Override control/label id for this row. |
-| `class`    | `ClassValue`  | —       | Row classes.                               |
-| `children` | `Snippet` | —       | `Title` and `Description` slots.           |
-
-### Title / Description
-
-Pass through shadcn `Item` title and description props (`class`, etc.).