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

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

@@ -1,41 +0,0 @@
-# bridge
-
-## Notes
-
-You build the native side. It is reachable through two contracts the CLI cannot wire for you:
-
-- **The message channel.** Your native host receives requests on `window.webkit.messageHandlers.bridge` and must post each reply/event back as a `window` `'bridge'` `CustomEvent` (a `Detail`). `available()` is `true` only inside such a host; in a plain browser `platform`/`version` are `null` and `semver()` is `false`, so gate any request on `available()` (a request fired with no host never gets a reply).
-- **The detection markers** — change these to match your wrapper:
-  - **Android package id** (`svc/bridge.ts`) — detected by `document.referrer.startsWith('android-app://com.example.twa')`. Replace the placeholder `com.example.twa` with your Trusted Web Activity package id.
-  - **`PWAShell` UA marker** (`svc/bridge.ts`) — iOS is detected by a `PWAShell` token in `navigator.userAgent`, with the version parsed from `PWAShell/<version>`. Have your iOS WebView host append the same marker (`… PWAShell/1.2.3`), or change both regexes to your own.
-
-## Usage
-
-```ts
-import { bridge } from '@/bridge'
-
-if (bridge.platform === 'ios' && bridge.semver('>=1.2.0')) {
-  if (await bridge.purchases.available()) {
-    const products = await bridge.purchases.products(['premium_yearly'])
-    // …drive a purchase, then bridge.purchases.finish(transactionID)
-  }
-}
-
-bridge.transmission.onNotificationClick((n) => {
-  if (n.action) location.assign(n.action)
-})
-```
-
-## API
-
-| Symbol                          | Description                                                                                  |
-| ------------------------------- | -------------------------------------------------------------------------------------------- |
-| `bridge.platform`               | `'ios' \| 'android' \| null` — native host detected from UA / referrer; `null` in a browser. |
-| `bridge.version`                | Native host version string parsed from the `PWAShell/<version>` UA marker, else `null`.      |
-| `bridge.semver(pattern)`        | `true` when `version` satisfies the semver `pattern`; `false` when there is no native host.   |
-| `bridge.available()`            | `true` when the native message handler is reachable in the current environment.              |
-| `bridge.purchases`              | StoreKit operations: `available()`, `products(ids)`, `purchase(id, token)`, `restore()`, `manage()`, `finish(txId)`. |
-| `bridge.transmission`           | Push channel: `address()`, `permission()`, `request()`, `delete()`, `onNotification(cb)`, `onNotificationClick(cb)`. |
-| `on(key, cb)` / `send(label, args?)` | Low-level transport: subscribe to a reply id / event label, or fire-and-forget a message. |
-
-Every `purchases`/`transmission` request resolves to its typed result **or** an `Error` (a native-side failure) — narrow with `instanceof Error` before use.

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

@@ -1,23 +0,0 @@
-# Clipboard
-
-Copies `text` (string or async retriever) to the system clipboard. Shows a checkmark for 2s after success. Disabled when `navigator.clipboard` is unavailable (non-secure context).
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { Clipboard } from '$com/clipboard'
-</script>
-
-<Clipboard text="https://example.com/join/abc" label="Copy link" variant="outline" />
-```
-
-## Props
-
-| Prop     | Type                         | Default | Notes                                              |
-| -------- | ---------------------------- | ------- | -------------------------------------------------- |
-| `text`   | `string \| () => Promise<string>` | —       | Value to copy. Retriever may return `null` to skip. |
-| `label`  | `string`                     | —       | Button label. Omit for icon-only.                  |
-| `oncopy` | `() => void`                 | —       | Fires after a successful copy.                     |
-
-All other props pass through to the underlying `Button`.

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

@@ -1,75 +0,0 @@
-# Dismissable
-
-Horizontal swipe-to-dismiss wrapper with optional slide-out animation. Swiping far enough triggers `ondismiss` immediately; calling `dismiss()` on a bound instance plays the slide-out first, then `ondismiss`. `remove()` animates out without calling `ondismiss`.
-
-Set `dismissable={false}` to disable the swipe sentinel — use when dismissal is programmatic only.
-
-## Usage
-
-### Swipe to dismiss
-
-```svelte
-<script lang="ts">
-  import { Dismissable } from '$com/dismissable'
-
-  let visible = $state(true)
-
-  async function ondismiss() {
-    visible = false
-  }
-</script>
-
-{#if visible}
-  <Dismissable {ondismiss}>
-    <div class="rounded-lg border bg-muted px-4 py-3">Swipe left to dismiss</div>
-  </Dismissable>
-{/if}
-```
-
-### Clear all
-
-Bind each row, call `remove()` on every ref with a short stagger (`delay` from `$lib/tools`), then drop them from state — `remove()` skips per-row `ondismiss`.
-
-```svelte
-<script lang="ts">
-  import { Dismissable } from '$com/dismissable'
-  import { delay } from '$lib/tools'
-
-  type Ref = { remove: () => Promise<void> | void }
-
-  let items = $state(['One', 'Two', 'Three'])
-  const refs = $state<Array<Ref | undefined>>([])
-
-  async function clearAll() {
-    const removed = refs.map((ref, i) => delay(() => ref?.remove(), i * 50))
-
-    await Promise.all(removed)
-    items = []
-  }
-</script>
-
-<button onclick={clearAll}>Clear all</button>
-
-{#each items as item, i (item)}
-  <Dismissable bind:this={refs[i]} ondismiss={() => (items = items.filter((x) => x !== item))}>
-    <div class="rounded-lg border bg-muted px-4 py-3">{item}</div>
-  </Dismissable>
-{/each}
-```
-
-## Props
-
-| Prop          | Type                              | Default | Notes                                                                 |
-| ------------- | --------------------------------- | ------- | --------------------------------------------------------------------- |
-| `children`    | `Snippet`                         | —       | Content inside the swipe track.                                       |
-| `ondismiss`   | `() => Promise<void> \| void`     | —       | Swipe-to-sentinel fires immediately; `dismiss()` fires after animation. |
-| `dismissable` | `boolean`                         | `true`  | When `false`, hides the swipe sentinel and disables swipe dismissal.  |
-
-## Instance methods
-
-Bind with `bind:this` to call programmatic dismissal:
-
-| Method     | Notes                                                          |
-| ---------- | -------------------------------------------------------------- |
-| `dismiss()` | Slide-out animation, then `ondismiss`.                        |
-| `remove()`  | Slide-out animation only — no `ondismiss`.                    |

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

@@ -1,153 +0,0 @@
-# Dropdown
-
-Composable action menu with CSS anchor positioning, view-transition morph on open/close, and optional nested layers. Import as a namespace (`import * as Dropdown from '$com/dropdown'`).
-
-## Usage
-
-### Basic
-
-```svelte
-<script lang="ts">
-  import { Ellipsis } from '@lucide/svelte'
-  import * as Dropdown from '$com/dropdown'
-
-  let menu: Dropdown.Root | undefined
-</script>
-
-<Dropdown.Root bind:this={menu}>
-  <Dropdown.Trigger variant="outline" size="icon">
-    <Ellipsis />
-  </Dropdown.Trigger>
-  <Dropdown.Content>
-    <Dropdown.Group direction="col">
-      <Dropdown.Item onclick={() => menu?.close()}>Edit</Dropdown.Item>
-      <Dropdown.Item>More…</Dropdown.Item>
-    </Dropdown.Group>
-  </Dropdown.Content>
-</Dropdown.Root>
-```
-
-### Nested layers
-
-Initially layers with `name` are hidden. Items with `layer` push a named layer. `Back` pops the current layer.
-
-```svelte
-<script lang="ts">
-  import { Ellipsis } from '@lucide/svelte'
-  import * as Dropdown from '$com/dropdown'
-
-  let menu: Dropdown.Root | undefined
-</script>
-
-<Dropdown.Root bind:this={menu}>
-  <Dropdown.Trigger variant="outline" size="icon">
-    <Ellipsis />
-  </Dropdown.Trigger>
-  <Dropdown.Content>
-    <Dropdown.Layer>
-      <Dropdown.Group direction="col">
-        <Dropdown.Item onclick={() => menu?.close()}>Edit</Dropdown.Item>
-        <Dropdown.Item layer="more">More…</Dropdown.Item>
-      </Dropdown.Group>
-    </Dropdown.Layer>
-    <Dropdown.Layer name="more">
-      <Dropdown.Group direction="col">
-        <Dropdown.Back />
-        <Dropdown.Item onclick={() => menu?.close()}>Archive</Dropdown.Item>
-      </Dropdown.Group>
-    </Dropdown.Layer>
-  </Dropdown.Content>
-</Dropdown.Root>
-```
-
-### Actions
-
-Typical use case for Dropdown is navigation actions.
-Wrap it with `<Actions>` from `shell` component, pass `active` store to control mute of the main navigation.
-
-```svelte
-<script lang="ts">
-  import { writable } from 'svelte/store'
-  import { Actions } from '$com/shell'
-  import * as Dropdown from '$com/dropdown'
-
-  const active = writable(false)
-</script>
-
-<Actions active={active}>
-  <Dropdown.Root bind:this={menu} onopen={(open) => active.set(open)}>
-    <Dropdown.Trigger variant="outline" size="icon">
-      <Ellipsis />
-    </Dropdown.Trigger>
-    <Dropdown.Content>
-      <Dropdown.Group direction="col">
-        <Dropdown.Item onclick={() => menu?.close()}>Edit</Dropdown.Item>
-        <Dropdown.Item>More…</Dropdown.Item>
-      </Dropdown.Group>
-    </Dropdown.Content>
-  </Dropdown.Root>
-</Actions>
-```
-
-## Props
-
-### Root
-
-| Prop       | Type                      | Default | Notes                                      |
-| ---------- | ------------------------- | ------- | ------------------------------------------ |
-| `children` | `Snippet`                 | —       | `Trigger` and `Content` slots.             |
-| `onopen`   | `(open: boolean) => void` | —       | Fires when open state changes.             |
-
-**Methods** (via `bind:this`): `open()`, `close()`.
-
-### Trigger
-
-Extends shadcn `Button` props (`variant`, `size`, `class`, …).
-
-| Prop       | Type      | Default | Notes                                |
-| ---------- | --------- | ------- | ------------------------------------ |
-| `children` | `Snippet` | —       | Trigger label or icon.               |
-| `id`       | `string`  | —       | Passed to the underlying `Button`.   |
-
-### Content
-
-| Prop       | Type                                                                 | Default         | Notes                                                                 |
-| ---------- | -------------------------------------------------------------------- | --------------- | --------------------------------------------------------------------- |
-| `children` | `Snippet`                                                            | —               | `Layer`, `Group`, `Item`, `Separator` slots.                          |
-| `class`    | `ClassValue`                                                         | —               | Panel wrapper classes.                                                |
-| `position` | `'start-top' \| 'start-bottom' \| 'end-top' \| 'end-bottom'`         | `'end-bottom'`  | Corner where menu aligns with the trigger; menu grows outward from it. |
-
-### Layer
-
-| Prop       | Type      | Default | Notes                                                                 |
-| ---------- | --------- | ------- | --------------------------------------------------------------------- |
-| `name`     | `string`  | `''`    | Layer id. Default layer uses `''`; push targets use a non-empty name. |
-| `children` | `Snippet` | —       | Shown when this layer is active.                                      |
-
-### Group
-
-| Prop        | Type               | Default | Notes                                      |
-| ----------- | ------------------ | ------- | ------------------------------------------ |
-| `children`  | `Snippet`          | —       | `Item` or custom content.                  |
-| `direction` | `'col' \| 'row'`   | `'col'` | Layout for items; affects `itemVariants`.  |
-| `class`     | `ClassValue`       | —       | Wrapper classes.                           |
-
-### Item
-
-Extends shadcn `Button` props. Export `itemVariants` for custom buttons in a row group.
-
-| Prop       | Type      | Default   | Notes                                                         |
-| ---------- | --------- | --------- | ------------------------------------------------------------- |
-| `children` | `Snippet` | —         | Row content (icon + label).                                   |
-| `layer`    | `string`  | —         | When set, click pushes this layer instead of calling `onclick`. |
-| `variant`  | `string`  | `'ghost'` | Button variant.                                               |
-
-### Back
-
-Same props as `Item` except `onclick` / `layer` (handled internally). Optional label snippet after the back arrow.
-
-### Separator
-
-| Prop       | Type      | Default | Notes                              |
-| ---------- | --------- | ------- | ---------------------------------- |
-| `children` | `Snippet` | —       | Optional centered label between rules. |

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

@@ -1,29 +0,0 @@
-# fragments
-
-## Notes
-
-- **Mount `<Fragments />` once** in your root `+layout.svelte`. It runs on the first (landing) navigation only and drives the consume-on-read cleanup; without it, read values are never stripped from the hash.
-- `fragment(name)` returns the value present in the landing URL's hash, or `null` when absent. The hash is snapshotted once at module load, so reads are stable across the session even as the bar is rewritten; the actual URL is cleaned on the next navigation.
-- SSR-safe: on the server the hash is empty, so `fragment()` returns `null` and `<Fragments />` is inert until hydration.
-
-## Usage
-
-```svelte
-<!-- src/routes/+layout.svelte -->
-<script lang="ts">
-  import { Fragments } from '@/fragments/ui'
-</script>
-
-<Fragments />
-{@render children()}
-```
-
-```ts
-// anywhere a one-shot hash value is expected, e.g. a returning redirect
-import { fragment } from '@/fragments'
-
-const session = fragment('stripe')
-if (session) {
-  // …resume the flow for this session id; the hash is cleaned on next navigation
-}
-```

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

@@ -1,157 +0,0 @@
-# Fullscreen
-
-Tap-to-expand overlay portaled to `body`. Wraps open/close in `transit()` for view transitions. Default mode: `children` is the trigger and the fullscreen body. Use `content` when the trigger and the overlay body should differ.
-
-## Usage
-
-### Zoom a thumbnail
-
-Same markup in the trigger and in fullscreen — good for photo zoom. Put `view-transition-name` on the image; add `fullscreen-content` for correct morph stacking.
-
-```svelte
-<script lang="ts">
-  import { Fullscreen } from '$com/fullscreen'
-
-  const id = 'photo-1'
-  let zoomed = $state<string | null>(null)
-</script>
-
-<Fullscreen class="h-[300px]" fragile onshow={() => (zoomed = id)} x={false}>
-  <img
-    src="/photo.jpg"
-    alt=""
-    class="h-full object-contain fullscreen-content"
-    style={`${zoomed === id ? 'view-transition-name: photo;' : ''} view-transition-class: transition-spring transition-morph;`} />
-</Fullscreen>
-```
-
-Set the transition name only while open (`onshow` + conditional style) when several Fullscreens sit in a list — otherwise every thumbnail joins the same morph.
-
-### Button → content
-
-When a button (or file input, share target, …) opens different fullscreen UI, split trigger and body: `controlled`, `content`, and `bind:this` → `show()` / `hide()`.
-
-Morph from the button into `content` with `takeoff` + `styles` (same transition name on both sides):
-
-```svelte
-<script lang="ts">
-  import { Button } from '$ui/button'
-  import { styles, takeoff } from '$lib/tools'
-  import { Fullscreen } from '$com/fullscreen'
-
-  const morph = 'transition-spring transition-morph fullscreen-content'
-
-  let fullscreen = $state<Fullscreen | null>(null)
-  const contentStyle = styles('upload', morph)
-
-  function open() {
-    takeoff('upload-button', 'upload', morph)
-    fullscreen?.show()
-  }
-</script>
-
-<Fullscreen bind:this={fullscreen} controlled>
-  <Button id="upload-button" onclick={open}>Upload</Button>
-  {#snippet content()}
-    <div class="max-w-md p-4 fullscreen-content" style={$contentStyle}>
-      <!-- progress, preview, … -->
-    </div>
-  {/snippet}
-</Fullscreen>
-```
-
-No visible trigger? Pass an empty `<div></div>` as `children` and call `show()` from `onMount` (share-target flow).
-
-### Overlay toolbar
-
-Actions above the content — delete, share, etc. Disable the default ✕ (`x={false}`) when the overlay dismisses.
-
-```svelte
-<script lang="ts">
-  import { Hold } from '$com/hold'
-  import { Fullscreen } from '$com/fullscreen'
-
-  let fullscreen = $state<Fullscreen | null>(null)
-</script>
-
-<Fullscreen bind:this={fullscreen} fragile x={false}>
-  <img src="/photo.jpg" alt="" class="fullscreen-content" style="view-transition-name: photo; …" />
-  {#snippet overlay()}
-    <div class="flex justify-end p-4 tim:pt-[env(safe-area-inset-top)]">
-      <Hold label="hold to delete" variant="outline" size="icon" onclick={() => fullscreen?.hide()}>
-        <!-- icon -->
-      </Hold>
-    </div>
-  {/snippet}
-</Fullscreen>
-```
-
-### Store-driven open
-
-When `open` comes from a store or parent, still wrap the flip in `transit()` — `show()` / `hide()` do that; raw `open = true` skips the animation.
-
-```svelte
-<script lang="ts">
-  import { transit } from '$lib/tools'
-  import { Fullscreen } from '$com/fullscreen'
-
-  let open = $state(false)
-
-  async function present() {
-    await transit(() => (open = true))
-  }
-</script>
-
-<Fullscreen bind:open>
-  <div></div>
-  {#snippet content()}
-    <!-- paywall, modal flow, … -->
-  {/snippet}
-</Fullscreen>
-```
-
-Optional: `takeoff(sourceId, name, classes)` before `transit` when morphing from another element on the page (CTA button → paywall card).
-
-## Props
-
-| Prop         | Type           | Default | Notes                                                                 |
-| ------------ | -------------- | ------- | --------------------------------------------------------------------- |
-| `children`   | `Snippet`      | —       | Trigger markup; also fullscreen body when `content` is omitted.       |
-| `content`    | `Snippet`      | —       | Fullscreen-only body; trigger stays on the page.                      |
-| `overlay`    | `Snippet`      | —       | Toolbar/actions above content; rendered inside `Overlay`.             |
-| `open`       | `boolean`      | `false` | Bindable. Mutate inside `transit()` unless using `show()` / `hide()`. |
-| `onshow`     | `() => void`   | —       | Fires when `show()` starts.                                           |
-| `onhide`     | `() => void`   | —       | Fires after the close transition finishes.                            |
-| `class`      | `ClassValue`   | —       | Classes on the trigger button (ignored when `controlled`).            |
-| `fragile`    | `boolean`      | `false` | Close on backdrop pointer down.                                       |
-| `controlled` | `boolean`      | `false` | No built-in trigger; call `show()` / `hide()` yourself.               |
-| `x`          | `boolean`      | `true`  | Top-trailing close button.                                            |
-
-`bind:this` exposes `show()` and `hide()`. `Overlay` accepts `children` and optional `class`.
-
-## Notes
-
-### Opening and closing
-
-- Prefer `show()` / `hide()` or `await transit(() => (open = …))`. Assigning `open` directly bypasses the view transition.
-- In `controlled` mode, Escape and backdrop tap (`fragile`) do nothing — close with `hide()`, `transit(() => (open = false))`, or a control in `overlay`.
-- Pair `controlled` + `bind:open` when async work should finish only while open: `if (open) callback?.(id)`.
-
-### `children` vs `content`
-
-| Setup | Trigger | Fullscreen body | Typical use |
-| ----- | ------- | --------------- | ----------- |
-| `children` only | wrapped in a button | same `children` | Thumbnail zoom |
-| `controlled` + `content` | `children` stays in place | `content` snippet | Button → upload progress, paywall |
-
-### View transitions
-
-- Shared name on source and target: inline `view-transition-name` on the thumbnail, or `takeoff(id, name, classes)` + `styles(name, classes)` on `content`.
-- Add `view-transition-class: transition-spring transition-morph` and class `fullscreen-content` on the morphing element — matches built-in z-index (`::view-transition-group(.fullscreen-content)`).
-- Content above the default stack? Add a scoped rule, e.g. `::view-transition-group(paywall) { z-index: 4; }`.
-- List of items: unique name per row; set it only for the open item (see thumbnail example above).
-
-### Overlay
-
-- Set `x={false}` when `overlay` owns dismiss/delete.
-- The built-in trigger hides `[data-slot=fullscreen-overlay]` descendants so overlay chrome does not appear in the thumbnail.

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

@@ -1,27 +0,0 @@
-# geo
-
-Consent-zone lookup. Resolves whether the current visitor sits in a prior-consent jurisdiction (where a consent banner must be shown before loading trackers) by querying your API through the `@/net` origin. Headless — service only, no UI.
-
-## Notes
-
-- **Backend contract** — exposes `geo()`, which `GET`s `/geo/` on your API (resolved against `$config.origin` via `@/net`). The endpoint must answer with `{ "privacy": boolean, "country"?: string }`, where `privacy: true` means the visitor is inside a prior-consent zone. Typically your backend derives this from the request IP / edge geolocation headers.
-- **Dev override** — when running in dev, a `?privacy=0|1` query param short-circuits the backend lookup so you can force either branch locally (`?privacy=1` → in-zone, `?privacy=0` → out-of-zone). The override is dev-only and browser-only; production always defers to the API.
-- **Failure** — a network/parse failure resolves to an `Error` (not a throw); the caller decides the safe default (typically: show the banner).
-
-## Usage
-
-```ts
-import { geo } from '@/geo'
-
-const zone = await geo()
-
-if (zone instanceof Error) {
-  // lookup failed — default to the privacy-safe path (show the banner)
-} else if (zone.privacy) {
-  // prior-consent jurisdiction — collect consent before loading trackers
-}
-```
-
-## Props
-
-None — this Solution exports a single `geo()` function and the `Geo` type. It renders nothing.

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

@@ -1,31 +0,0 @@
-# Globals
-
-Shared theme tokens, Tailwind variants, and utility classes for antcn components.
-
-## What's included
-
-| Kind | Examples |
-| --- | --- |
-| CSS variables | `--constructive`, `--constructive-foreground`, `--destructive-foreground`, `--shadow-color` → `bg-constructive`, `text-constructive-foreground`, `text-destructive-foreground`, popover shadows |
-| Custom variants | `standalone:`, `tim:` |
-| Shared layers | `@layer transitions` — `transition-morph` / `transition-spring` / `transition-instant` timing, reduced-motion guard |
-| Utility classes | `.no-scrollbar` — hide scrollbars while keeping scroll; `.selected` — accent ring for selected rows |
-| Typography | `.typeset` — document rhythm for rendered Markdown, sized relative to its container |
-
-Component-specific view-transition rules stay in each component's `<style>` block.
-
-## Typography
-
-`.typeset` is [shadcn/typeset](https://ui.shadcn.com/docs/typeset), snapshotted from <https://ui.shadcn.com/typeset.css> on 2026-08-05. It has no registry entry and no npm package — it ships as a file plus a web builder, so it is vendored here as `typeset.css` and refreshing it is a diff against a fresh download.
-
-The file ships verbatim: `globals` carries it as a `registry:file` targeting `src/lib/typeset.css`, and its `css` carries the matching `@import '$lib/typeset.css'` key, which the CLI merges into your stylesheet — so after install you own a readable `typeset.css` and it is already wired. Edit it like any other file in your project.
-
-The deviation, one rule: upstream nests lists with a bare `:where(ul ul)`, so a structural `<ul>` _outside_ the typeset container counts as a nesting level and Markdown lists render `circle`. It is scoped to `.typeset ul ul` (and `.typeset ul ul ul`) instead. This is generic — any layout that puts a Markdown container inside a list hits it.
-
-Put the class on the element that roots a whole document, not on each Markdown fragment, so headings and prose share one typographic root. Elements inside it that are structure rather than prose opt out with explicit utilities — note that Tailwind v4 implements `space-y-*` as `margin-block-end`, which collides with typeset's list spacing, so spacing between structural items wants an explicit margin instead.
-
-## After install
-
-Installing or re-installing globals merges its `css` and `cssVars` into your project CSS (usually `src/app.css`). Simple tokens dedupe reliably; **complex selectors** — `@layer transitions`, `@custom-variant`, comma-grouped `::view-transition-*` rules — match by exact formatting. If your file is pretty-printed differently from what the CLI emits, overwrite may fail and rules get **appended as duplicates**.
-
-After each install, check your CSS and **delete duplicate blocks** (most often under `@layer transitions`). Replace the whole bloated section with one copy — don't leave stacked repeats.

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

@@ -1,69 +0,0 @@
-# Grammatical form
-
-In some languages the wording of a message depends on the subject's grammatical gender (`{name} added` vs Russian `{name} добавил` / `добавила`). svintl turns this into a translation concern, and the app stores a per-user choice — the same way it stores a chosen locale. It is **not** part of any one Solution: the mechanics live in the svintl host, the field on the account, and the picker in the consumer's profile.
-
-## How svintl exposes it
-
-Enable gender guidance once on the host dictionary (`$lib/intl`), listing the gender tokens your strings vary by — the **last** one is treated as the neutral/fallback form:
-
-```bash
-npx intl genders he she none   # writes `genders: [he, she, none]` to context.yaml
-npx intl genders               # prints the current values
-npx intl build                 # regenerates types + dictionaries
-```
-
-`build` then emits a `Grammar` union from those tokens:
-
-```ts
-// $lib/intl
-export type Grammar = 'he' | 'she' | 'none' // = string when genders is unset
-```
-
-Gender-dependent phrases become `!js` functions whose **last** argument is the gender; the phrase's own arguments (if any) come first. A phrase with no other placeholders is just `(gender) => …`:
-
-```yaml
-# one own argument (name) + gender
-example:
-  !js
-  (name, gender) => gender === 'he' ? `${name} добавил` : gender === 'she' ? `${name} добавила` : `${name} добавил(а)`
-# no own arguments — single gender param
-status:
-  !js
-  (gender) => gender === 'she' ? 'готова' : gender === 'he' ? 'готов' : 'готов(а)'
-```
-
-A language with no gender distinction for a phrase returns a plain string, not a function.
-
-## API field
-
-The subject's gender lives on the account as `grammar?: Grammar | null` (`Grammar` imported from `$lib/intl`). antcn's `iam` Solution already carries it on `Echo`. Persist the user's choice there.
-
-## Two consumption modes
-
-- **Current user** — for "you did X" texts, feed a `grammar` store derived from the active account (`$lib/intl` can expose `grammar = derived(account, $a => $a?.grammar ?? 'none')`).
-- **Per subject** — for "{name} did X" texts about *other* people, pass that account's own field explicitly: `$dict.contacts.transferred.received(name, amount, account.grammar)`. Forgetting this is the common bug — the dictionary function needs the *subject's* gender, not the viewer's.
-
-## Picker (interface pattern — not shipped by antcn)
-
-Mirror the language switcher: a small control that edits `account.grammar` and reports the choice for persistence, exactly like the `locale` Solution's `Languages` / `Language` report a `Locale` via `onselect`.
-
-```svelte
-<script lang="ts">
-  import type { Grammar } from '$lib/intl'
-  import { me } from '@/accounts'
-
-  // value seeded from account.grammar; toggle-group over the gender tokens
-  function persist(grammar: Grammar) {
-    void me.update({ grammar })
-  }
-</script>
-```
-
-Suggested interface:
-
-| Prop       | Type                          | Notes                                              |
-| ---------- | ----------------------------- | -------------------------------------------------- |
-| `value`    | `Grammar \| ''`               | Current account gender; `''` for unset             |
-| `onselect` | `(grammar: Grammar) => void`  | Fires after the choice changes; persist it         |
-
-A toggle-group of the gender tokens (e.g. `he` / `she` / `none` with icons) is the proven shape.

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

@@ -1,44 +0,0 @@
-## hint
-
-Per-account dismissable onboarding hints — acknowledge a hint permanently, or snooze it until a timestamp. State is persisted under the signed-in `@/iam` account, so each user sees each hint once (or once per snooze window).
-
-`Hints` is intentionally an **empty interface extending `Record<string, Hint | undefined>`**. Declare your hint keys by extending it; `acknowledge` / `later` / `unfamiliar` then narrow to those keys.
-
-## Notes
-
-- **Requires `@/iam`.** The hint store binds to `@/iam`'s `account` and clears on logout — no account, no persisted hints. Pulled automatically via `local:iam`.
-- **No UI ships.** This Solution is service-only; render the prompt with whatever surface you like (a `Card`, banner, dialog). `unfamiliar(key)` gates rendering; `acknowledge` / `later` dismiss it.
-- **Extending `Hints` is how you wire keys.** Without an `interface Hints` augmentation in your project, every key is valid but untyped. The `transmission` Solution does this for `transmission_permission`.
-
-## Usage
-
-Declare a hint key, then gate a prompt on `unfamiliar`:
-
-```ts
-// src/@/your-feature/svc/hints.ts
-import type { Hint } from '@/hints'
-
-declare module '@/hints' {
-  interface Hints {
-    welcome?: Hint
-  }
-}
-```
-
-```svelte
-<script lang="ts">
-  import { unfamiliar, acknowledge, later } from '@/hints'
-
-  const day = 24 * 60 * 60 * 1000
-</script>
-
-{#if unfamiliar('welcome')}
-  <Card>
-    <p>Welcome aboard.</p>
-    <Button onclick={() => later('welcome', 7 * day)}>Later</Button>
-    <Button onclick={() => acknowledge('welcome')}>Got it</Button>
-  </Card>
-{/if}
-```
-
-`unfamiliar(key)` returns `true` when there is no record for `key` **or** the record is a snooze (`value: false`) whose `expiration` has passed. `acknowledge(key)` writes `{ value: true }` (hides forever). `later(key, delay)` writes `{ value: false, expiration: Date.now() + delay }` (hides until then).