@teamblind-chorus/ui 1.0.1 → 1.1.0

package/agents/components/metadata/compact.spec.json

@@ -3,13 +3,18 @@
   "name": "Metadata",
   "family": "metadata",
   "subcomponent": "compact",
-  "description": "One-line author attribution for comment / reply rows — the [Standard](standard.md) head with its primary line (avatar + entity name + timestamp + follow) omitted. Only the secondary meta-link row renders, with the posting time relocated to the line's trailing edge: company name · nickname (bare, no @ prefix, optional single role badge) · timestamp. The identity items keep the standard meta-row grammar (independent `<a>` links, middot separators, badge outside the link); the timestamp is plain text in `sys.color.outline` so the line reads identity-first, time-last. `layoutInset: inline` — atom-shaped, pays no padding of its own; the host comment row owns the gutter / divider / click target.",
+  "description": "One-line channel-detail attribution — the slimmed [Standard](standard.md) head that keeps the leading 32-rung [Thumbnail](../thumbnail/thumbnail.md) but drops the primary name line, follow toggle, and subtitle (the info that is unnecessary once the channel context is already established). A leading avatar plus the identity meta-link row, with the posting time relocated to the line's trailing edge: avatar · company name · nickname (bare, no @ prefix, optional single role badge) · timestamp. The identity items keep the standard meta-row grammar (independent `<a>` links, middot separators, badge outside the link); the timestamp is plain text in `sys.color.outline` so the line reads identity-first, time-last. `layoutInset: inline` — atom-shaped, pays no padding of its own; the host row owns the gutter / divider / click target.",
   "element": "div",
   "props": {
     "variant": {
       "type": "literal",
       "value": "compact"
     },
+    "avatar": {
+      "type": "object",
+      "optional": true,
+      "description": "Leading [Thumbnail](../thumbnail/thumbnail.md) at `size={32}` — same prop and rung as the [Standard](standard.md) head. Forwards every Thumbnail prop verbatim (`{ src, alt }`). When omitted, the Thumbnail renders its image-area fallback over `surfaceContainerHigh`."
+    },
     "meta": {
       "type": "node",
       "required": true,
@@ -18,15 +23,23 @@
     "timestamp": {
       "type": "string",
       "required": true,
-      "description": "Posting time at the line's trailing edge — plain text (never a link), preceded by a middot, in `label.sm` / `sys.color.outline` so it recedes behind the identity links. Required: the timestamp is what distinguishes a compact attribution from a bare identity row."
+      "description": "Posting time at the line's trailing edge — plain text (never a link), in `label.sm` / `sys.color.outline` so it recedes behind the identity links. NOT preceded by a middot: the time is separated from the identity cluster by an `inline.md` (8) gap so it reads as a distinct trailing element rather than another identity item (mirrors the Standard head's name↔time treatment). Required: the timestamp is what distinguishes a compact attribution from a bare identity row."
     }
   },
   "slots": {
     "container": {
       "required": true,
-      "description": "Outer row — hosts the single text line. `min-width: 0` so the line can truncate inside a flexed comment row.",
+      "description": "Outer row — flex row, `align-items: center`, hosting the leading avatar and the single text line. `min-width: 0` so the line can truncate inside a flexed host row.",
       "intrinsic": true
     },
+    "avatar": {
+      "required": false,
+      "description": "Leading [Thumbnail](../thumbnail/thumbnail.md) at `size={32}` — identical to the Standard head. Vertically centered against the one-line meta cluster.",
+      "accepts": [
+        "thumbnail"
+      ],
+      "rendersAs": "thumbnail:32"
+    },
     "meta": {
       "required": true,
       "description": "Identity meta-link row — company name then nickname, each its own `<a>`; siblings separate by middot; `flex-wrap: nowrap` so the cluster stays a single text line. Hover paints the underline on the link alone — the middot stays unstyled.",
@@ -34,7 +47,7 @@
     },
     "timestamp": {
       "required": true,
-      "description": "Trailing plain-text posting time after the last middot. `sys.typo.label.sm` / `sys.color.outline` — one tonal step further than the identity links.",
+      "description": "Trailing plain-text posting time after the identity cluster — no leading middot, separated by an `inline.md` (8) gap. `sys.typo.label.sm` / `sys.color.outline` — one tonal step further than the identity links.",
       "accepts": [
         "text"
       ]
@@ -54,13 +67,13 @@
     "note": "Compact Metadata itself has no lifecycle states — each identity link carries its own state contract; the timestamp is inert."
   },
   "behavior": {
-    "dotHeight": "Every middot separator (between identity items and before the timestamp) uses `line-height: 1` so its line-box matches its font-size — same family-wide rule as the standard sub.",
+    "dotHeight": "Every middot separator (between identity items) uses `line-height: 1` so its line-box matches its font-size — same family-wide rule as the standard sub. The timestamp carries no leading middot — it is separated from the identity cluster by an `inline.md` gap.",
     "linkAffordances": "Identity items render as independent `<a>` elements — taps land on the link, not the host row. The timestamp is plain text and never intercepts the row's own tap target.",
     "singleLine": "The cluster is one text line — the meta row never wraps. When the host row is narrower than the cluster, the identity links truncate; the timestamp keeps its full width.",
     "metaBadge": "An object identity item's `badge` node renders after the item's `<a>` at the middots' 4px (`inline.sm`) gap — the mark annotates the nickname without becoming link content."
   },
   "forbidden": [
-    "avatar, entity-name primary line, follow toggle, subtitle, or trailing slot painted on the compact form — those belong to the [Standard](standard.md) head; compact is the one-line text-only shape",
+    "entity-name primary line, follow toggle, subtitle, or trailing slot painted on the compact form — those belong to the [Standard](standard.md) head; compact keeps only the leading avatar plus the one-line identity / timestamp",
     "timestamp omitted or rendered as a link — the plain trailing timestamp anchors the line and is what makes it an attribution",
     "timestamp placed before the identity items — the canonical order is company · nickname · timestamp, time last",
     "nickname displayed with an @ prefix — nicknames render bare, family-wide",

package/agents/components/metadata/metadata.family.json

@@ -2,7 +2,7 @@
   "$schema": "../../family.schema.json",
   "family": "metadata",
   "name": "Metadata",
-  "description": "Author / brand attribution cluster shared by [Feed Post](../feed/post.md) and [Feed Ad](../feed/ad.md). A leading 32-rung [Thumbnail](../thumbnail/thumbnail.md), a primary line (entity name + optional inline timestamp + optional follow toggle), and an optional secondary line (a plain `subtitle` text — canonical 'Sponsored' for ads — or an array of independently-linked `meta` items: location, job function, and — canonically last — the user's nickname, displayed bare with no @ prefix). Optional trailing slot hosts a row-level affordance like the dismiss × button on ads. The one-line [Compact](compact.md) sub drops the primary line for comment / reply attribution: company name · nickname (optional role badge) · trailing timestamp. The middot separator's line-box is constrained to its font-size so the dot never inflates the surrounding text line.",
+  "description": "Author / brand attribution cluster shared by [Feed Post](../feed/post.md) and [Feed Ad](../feed/ad.md). A leading 32-rung [Thumbnail](../thumbnail/thumbnail.md), a primary line (entity name + optional inline timestamp + optional follow toggle), and an optional secondary line (a plain `subtitle` text — canonical 'Sponsored' for ads — or an array of independently-linked `meta` items: location, job function, and — canonically last — the user's nickname, displayed bare with no @ prefix). Optional trailing slot hosts a row-level affordance like the dismiss × button on ads. The one-line [Compact](compact.md) sub keeps the leading 32-rung avatar but drops the primary name line, follow toggle, and subtitle — channel-detail attribution: avatar · company name · nickname (optional role badge) · trailing timestamp. The middot separator's line-box is constrained to its font-size so the dot never inflates the surrounding text line.",
   "useCases": [
     "feed post author attribution",
     "feed ad brand attribution",
@@ -13,7 +13,7 @@
   "layoutInset": "inline",
   "wrapperGuidance": "Atom — pays no inline padding of its own. Sits inside whichever Feed sub-component composes it (Post / Ad card head); the host pays surrounding rhythm. Do NOT wrap Metadata in a per-row padding-inline div.",
   "usage": {
-    "note": "Both shapes are the single `Metadata` export — the one-line comment shape is `variant=\"compact\"`, NOT a separate `<MetadataCompact>`. Leading thumbnail is the `avatar` prop (NOT `thumbnail`); the secondary line is either a `subtitle` string or a `meta` string array — not children.",
+    "note": "Both shapes are the single `Metadata` export — the one-line channel-detail shape is `variant=\"compact\"`, NOT a separate `<MetadataCompact>`. Leading thumbnail is the `avatar` prop (NOT `thumbnail`) on both shapes; the secondary line is either a `subtitle` string or a `meta` string array — not children.",
     "subs": {
       "standard": {
         "import": "Metadata",
@@ -21,7 +21,7 @@
       },
       "compact": {
         "variant": "compact",
-        "example": "<Metadata variant=\"compact\" meta={[\"Maple Mill Bakery\", \"ryestarter\"]} timestamp=\"35m\" />"
+        "example": "<Metadata variant=\"compact\" avatar={{ src, alt }} meta={[\"Maple Mill Bakery\", \"ryestarter\"]} timestamp=\"35m\" />"
       }
     }
   },

package/agents/components/metadata/metadata.md

@@ -1,6 +1,8 @@
 # Metadata
 
-Author / brand attribution cluster. The family covers two shapes riding the same `label.sm` text grammar: **[Standard](./standard.md)** — the avatar + two-line head shared by [Feed Post](../feed/post.md) and [Feed Ad](../feed/ad.md) (entity name + optional timestamp / follow on top, subtitle or meta-link row below); **[Compact](./compact.md)** — the one-line comment / reply attribution (company name · nickname · timestamp, no avatar). Per-sub intent lives on each sub's page.
+> 🇰🇷 한국어: [`i18n/ko/schema/components/metadata/metadata.md`](../../../i18n/ko/schema/components/metadata/metadata.md)
+
+Author / brand attribution cluster. The family covers two shapes riding the same `label.sm` text grammar: **[Standard](./standard.md)** — the avatar + two-line head shared by [Feed Post](../feed/post.md) and [Feed Ad](../feed/ad.md) (entity name + optional timestamp / follow on top, subtitle or meta-link row below); **[Compact](./compact.md)** — the one-line channel-detail attribution (leading 32-rung avatar · company name · nickname · timestamp), the slimmed head with the name line, follow, and subtitle dropped. Per-sub intent lives on each sub's page.
 
 **Layout inset.** `inline` — Metadata ships no padding of its own. Sits inside whichever host composes it (Feed Post / Ad card head, comment row); the host pays surrounding rhythm, divider, and tap target.
 
@@ -23,4 +25,4 @@ Every identity item (entity name, meta items) is its own `<a>` — taps land on
 ## Sub-components
 
 - **[Standard](./standard.md)** *(default)* — Avatar + two-line attribution head for Feed Post / Feed Ad. Primary line (name + timestamp + follow) over an optional secondary line (subtitle or meta-link row); optional trailing affordance.
-- **[Compact](./compact.md)** — One-line comment / reply attribution: company name · nickname (optional role badge) · trailing plain timestamp. Reached as `variant="compact"` on the same `Metadata` export.
+- **[Compact](./compact.md)** — One-line channel-detail attribution: leading 32-rung avatar · company name · nickname (optional role badge) · trailing plain timestamp. The slimmed Standard head with the primary name line, follow, and subtitle dropped. Reached as `variant="compact"` on the same `Metadata` export.

package/agents/components/metadata/standard.md

@@ -1,5 +1,7 @@
 # Standard
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/metadata/standard.md`](../../../i18n/ko/schema/components/metadata/standard.md)
+
 The default attribution head of the [Metadata](./metadata.md) family, shared by [Feed Post](../feed/post.md) and [Feed Ad](../feed/ad.md). A leading 32-rung [Thumbnail](../thumbnail/thumbnail.md), a primary line (entity name + optional inline timestamp + optional follow toggle), and an optional secondary line (a plain `subtitle` text — canonical 'Sponsored' for ads — or an array of independently-linked `meta` items: location, job function, and — canonically last — the user's nickname, displayed bare with no @ prefix). Optional trailing slot hosts a row-level affordance like the dismiss × button on ads.
 
 **Reach for this when** composing the head of a Feed Post or Feed Ad — the cluster owns the avatar + identity + meta. **Skip when** you need a one-line comment / reply attribution — company name · nickname · timestamp, no avatar (use [Compact](./compact.md)) — a generic entity directory row with up to three text lines and a single trailing commit (use [list/entry](../list/entry.md)), a labelled-region heading (use [Header](../header/header.md)), or a profile / channel page hero (use [Profile header](../profile-header/profile-header.md)).
@@ -67,6 +69,28 @@ import { XIcon } from '@teamblind-chorus/ui/icons';
 />
 ```
 
+### With role badge
+
+A meta item in object form carries `badge` — a single presentational mark rendered after the item's link, outside the `<a>`, at the middots' 4px gap. Canonical fill: a role [Badge](../badge/badge.md) on the trailing nickname. At most one badge rides the nickname, never a stack.
+
+```preview
+metadata/standard/badge
+---
+import { Metadata, Badge } from '@teamblind-chorus/ui';
+
+<Metadata
+  avatar={{ src: '/placeholder.png', alt: 'Sourdough Bakers' }}
+  name="Sourdough Bakers"
+  nameHref="#"
+  timestamp="2h"
+  meta={[
+    'Brooklyn, NY',
+    'Home baker',
+    { label: 'crustcrumb', href: '#', badge: <Badge variant="role">Verified</Badge> },
+  ]}
+/>
+```
+
 ## Slots
 
 - **container** — outer flex row. `align-items: center`, `sys.layout.inline.md` (8px) gap between avatar, text column, and trailing slot.

package/agents/components/nav-card/nav-card.md

@@ -1,5 +1,7 @@
 # Nav card
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/nav-card/nav-card.md`](../../../i18n/ko/schema/components/nav-card/nav-card.md)
+
 A bounded single-row card — outlined rounded surface with a label, optional supporting line, and optional trailing affordance. Two variants pick the trailing shape: `default` ships no trailing icon (bare labelled tile), `nav` auto-renders the right-pointing chevron (explicit drill-in). The whole card is the tap target.
 
 **Reach for this when** one row needs to read as its own discrete affordance — a labelled scope tile (`default`), a standalone settings drill-in (`nav`), a picker trigger, or a channel / sub-brand entry card. **Skip when** rows stack into a vertical column (use a [List](../list/list.md) drill-in row — `nav: true`), the action is a commit (use [Button](../button/button.md)), or the surface is purely informational (use [Banner](../banner/banner.md)).

package/agents/components/nav-list/nav-list.md

@@ -1,5 +1,7 @@
 # Nav list
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/nav-list/nav-list.md`](../../../i18n/ko/schema/components/nav-list/nav-list.md)
+
 A vertical label-only nav list — labelled block where each row carries a label (and an optional supporting line) plus a trailing chevron Icon Button, and routes via `href` / `onClick`. Bundles a [Header](../header/header.md) over a label-only [List](../list/entry.md) `variant="entry"` so the section title and the route group come as one composition. Anatomy is intentionally label-only — `thumbnail` is omitted on every row, the leading column collapses, and the trailing rail carries a default [Icon Button](../button/icon.md) with a right-pointing chevron.
 
 **Reach for this when** the screen shows a category index, settings menu, or any "pick a sub-page" set where each row is purely a route target. **Skip when** the rows need a leading thumbnail (use [DirectoryList](../directory-list/directory-list.md)) or the rows commit in place rather than route (use [List](../list/standard.md) `variant="standard"`).

package/agents/components/navigation-bar/main.md

@@ -1,5 +1,7 @@
 # Main
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/navigation-bar/main.md`](../../../i18n/ko/schema/components/navigation-bar/main.md)
+
 The landing-screen top bar — anchored to a tab root (feed, inbox, profile). A leading menu glyph plus left-aligned page name sit at the start; **up to four** trailing icon actions (conventionally search, chat, profile) sit at the end. Title carries the system's largest page-level rung (`typo.heading.lg`, 24/Semibold). The same row also serves a **drill-in (content-detail) screen** — pass `onBack` instead of `onMenuClick` and the leading glyph swaps to a back chevron, with the trailing cluster carrying up to four actions (see [Use cases](#use-cases)).
 
 **Reach for this when** the screen is a tab root and needs the menu drawer plus a small set of global affordances, **or** when it's a content-detail drill-in (a post / article reached from a feed) needing back navigation plus a share-and-save cluster. **Skip when** you need a centred title with a single action (use [Sub](./sub.md)) or are on a dedicated search page (use [Search](./search.md)).

package/agents/components/navigation-bar/navigation-bar.md

@@ -1,5 +1,7 @@
 # Navigation bar
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/navigation-bar/navigation-bar.md`](../../../i18n/ko/schema/components/navigation-bar/navigation-bar.md)
+
 The top app bar — a horizontal strip pinned to the top of a screen that names the screen and exposes its highest-priority actions. Three sub-flavors share this contract: **Main** (landing-screen bar), **Sub** (drill-in bar with centred title), and **Search** (search-page bar with a bare-text input). All three sit at 16px inline / 8px block padding and delegate icon slots to [Icon Button](../button/icon.md).
 
 **Layout inset.** `full-bleed` — sits flush at the top of the page shell. The bar owns its own `16px inline / 8px block` padding via `layout.container.*`; do **not** wrap it in another `padding-inline` / `px-*` / `style={{ padding: … }}` div. The bar is pinned chrome, not a `<main>` child — sits *outside* the `<main>` that pays `sys.layout.page.*`. See [`AGENTS.md` § Composition rules](../../../AGENTS.md#composition-rules).

package/agents/components/navigation-bar/search.md

@@ -1,5 +1,7 @@
 # Search
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/navigation-bar/search.md`](../../../i18n/ko/schema/components/navigation-bar/search.md)
+
 The search top bar — anchored to a dedicated search page reached from a [Main](./main.md) or [Sub](./sub.md) bar's search trigger. Owns the entire search affordance: leading back-arrow Icon Button, single bare-text input filling the row, conditional trailing clear (*×*). Drops the centred title — the input *is* the focus.
 
 **Reach for this when** the entire screen exists to capture a query and show results. **Skip when** search is one affordance among several on a tab root (use [Main](./main.md) with a search trailing action) or when the field lives in-line with content (use the [search](../form-field/search.md) form-field).

package/agents/components/navigation-bar/sub.md

@@ -1,5 +1,7 @@
 # Sub
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/navigation-bar/sub.md`](../../../i18n/ko/schema/components/navigation-bar/sub.md)
+
 The drill-in top bar — anchored to every screen one step inside a flow. Centred page name, flanked by two independent side slots — each optionally a [Text Button](../button/text.md), an [Icon Button](../button/icon.md), or a [Toolbar Button](../button/toolbar.md) / text link, chosen per side. The title itself is optional too: omit it when the side actions say everything (composer bars). Title drops from Main's `typo.heading.lg` to `typo.heading.sm` (16/Semibold).
 
 **Reach for this when** the screen is one step inside a flow and needs a back affordance plus a single primary action. **Skip when** you're on a tab root (use [Main](./main.md)) or a dedicated search page (use [Search](./search.md)).

package/agents/components/page-shell/page-shell.md

@@ -1,5 +1,7 @@
 # PageShell
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/page-shell/page-shell.md`](../../../i18n/ko/schema/components/page-shell/page-shell.md)
+
 The app scaffold that **pins** `NavigationBar` (top) and `TabBar` (bottom) while only the body scrolls.
 
 ## Why it exists

package/agents/components/pagination/pagination.family.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "../../family.schema.json",
+  "family": "pagination",
+  "name": "Pagination",
+  "description": "Decorative dot-position indicator for one-page-at-a-time pagers. An inline element (`span` / inline-flex) sized to its dots — one 6px dot per page; the active dot paints `sys.color.onSurface`, the rest paint `sys.color.outlineVariant`. Presentational only (`aria-hidden`) — the host pager owns horizontal placement (the carousels center it), scroll position, active-index tracking, and keyboard reach; tapping a dot does not navigate. Renders nothing below two pages. Single appearance, single rung. Single-spec family.",
+  "useCases": [
+    "carousel page position (PostCarousel / ProfileCarousel)",
+    "swipeable media gallery position",
+    "onboarding pager position"
+  ],
+  "visualReuse": "open",
+  "layoutInset": "inline",
+  "spec": "pagination.md",
+  "usage": {
+    "note": "Decorative only — the root is `aria-hidden` and dots are not buttons. An inline element with intrinsic width: the host owns horizontal placement (e.g. centering under its pager) as well as the active index (e.g. via IntersectionObserver on its snap targets), and MUST keep later pages keyboard-reachable on its own. Renders nothing when `count` < 2.",
+    "example": "<Pagination count={5} activeIndex={2} />"
+  },
+  "subcomponents": [
+    {
+      "slug": "pagination",
+      "spec": "pagination.spec.json",
+      "md": "pagination.md",
+      "default": true
+    }
+  ]
+}

package/agents/components/pagination/pagination.md

@@ -0,0 +1,40 @@
+# Pagination
+
+> 🇰🇷 한국어: [`i18n/ko/schema/components/pagination/pagination.md`](../../../i18n/ko/schema/components/pagination/pagination.md)
+
+Decorative dot-position indicator for one-page-at-a-time pagers — an inline row of 6px dots, one per page, the active dot painted `sys.color.onSurface` and the rest `sys.color.outlineVariant`.
+
+**Reach for this when** a horizontally-snapping pager needs to show where the user is — carousel cards ([PostCarousel](../carousel/post.md), [ProfileCarousel](../carousel/profile.md)), a swipeable media gallery, an onboarding pager. **Skip when** the position is a task-completion ratio (use [Progress](../progress/progress.md)), the pages need direct tap-to-jump navigation (dots here are non-interactive — use [Tabs](../tabs/tabs.md)), or the pager has only one page (the component renders nothing below two).
+
+**Layout inset.** `inline` — an inline element (`span`, `display: inline-flex`) exactly as wide as its dots, with no padding or fill of its own. It never stretches or centers itself; the host owns horizontal placement (the carousels center it via `align-self: center`) and the gap between its track and the dot row (`sys.layout.stack.md`).
+
+## Default
+
+Five pages with the third active. Dots are 6 × 6, fully rounded, `sys.layout.inline.sm` apart; the row is `aria-hidden` and renders at its intrinsic width — where it sits is the host's call.
+
+```preview
+pagination/default
+---
+import { Pagination } from '@teamblind-chorus/ui';
+
+<Pagination count={5} activeIndex={2} />
+```
+
+## Slots
+
+- **dot** *(decorative, one per page)* — 6 × 6 (`ref.space.75`), `sys.radius.full`. Active paints `sys.color.onSurface`; inactive paints `sys.color.outlineVariant`.
+
+## Anatomy
+
+| Slot | Token bindings |
+|------|----------------|
+| row  | inline element — `display: inline-flex`, intrinsic width, `sys.layout.inline.sm` gap, `aria-hidden`; horizontal placement belongs to the host |
+| dot  | 6 × 6 (`ref.space.75`), `sys.radius.full`; active `sys.color.onSurface`, inactive `sys.color.outlineVariant` |
+
+## Behavior
+
+- **Inline element.** A `span` with `display: inline-flex` and intrinsic width — the component paints no layout opinion beyond its own dot row. Centering under a pager (or any other placement) is a host binding: the carousels apply `align-self: center` on their own selector.
+- **Decorative.** The root carries `aria-hidden="true"`. Dots are not buttons; tapping one does not scroll. Because of this, the host MUST keep later pages reachable another way — focusable page contents in natural tab order, scroll-into-view on focus (see the carousel specs' `keyboardReach` rule).
+- **Host owns the index.** Pagination never observes scroll itself. The host derives `activeIndex` — typically an IntersectionObserver at a ~60% threshold on its scroll-snap targets — and the component paints it, clamped to `0..count-1`.
+- **Minimum two pages.** Renders nothing when `count` < 2; the host needs no conditional of its own.
+- **No emphasis axis.** A single appearance — active is `onSurface`, never a chromatic accent. Position is chrome, not a call to action.

package/agents/components/pagination/pagination.spec.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "../../spec.schema.json",
+  "name": "Pagination",
+  "family": "pagination",
+  "description": "Decorative dot-position indicator for one-page-at-a-time pagers. An inline element (`span`, `display: inline-flex`) sized to its dots — it never stretches or centers itself; the host owns horizontal placement (the carousels center it via `align-self: center`). Renders one 6px (`ref.space.75`) fully-rounded dot per page in a `sys.layout.inline.sm` row; the active dot paints `sys.color.onSurface`, the rest paint `sys.color.outlineVariant`. The row is presentational only (`aria-hidden`): the host pager (PostCarousel, ProfileCarousel, a media gallery) tracks the active index — typically via IntersectionObserver on its snap targets — and passes it down; tapping a dot does not navigate. Renders nothing when `count` < 2 — a one-page pager has no position to indicate.",
+  "element": "span",
+  "props": {
+    "count": {
+      "type": "number",
+      "default": 0,
+      "description": "Total number of pages — one dot renders per page. Below 2 the component renders nothing."
+    },
+    "activeIndex": {
+      "type": "number",
+      "default": 0,
+      "description": "Zero-based index of the active page. Clamped to `0..count-1`. Owned by the host pager (e.g. updated from an IntersectionObserver on its scroll-snap targets)."
+    }
+  },
+  "slots": {
+    "dot": {
+      "required": true,
+      "description": "One per page. 6 × 6 (`ref.space.75`), `sys.radius.full`. Active paints `sys.color.onSurface`; inactive paints `sys.color.outlineVariant`.",
+      "intrinsic": true
+    }
+  },
+  "sizing": {
+    "display": "inline-flex",
+    "displayNote": "Intrinsic width — the row is exactly as wide as its dots plus gaps. No `width`, no stretch, no self-centering; horizontal placement belongs to the host (the carousels apply `align-self: center` on their own selector).",
+    "dotSize": "ref.space.75",
+    "dotGap": "sys.layout.inline.sm",
+    "dotRadius": "sys.radius.full"
+  },
+  "appearance": {
+    "activeDot": "sys.color.onSurface",
+    "inactiveDot": "sys.color.outlineVariant"
+  },
+  "states": {
+    "default": { "note": "Pagination carries no lifecycle states — the active index is its visual state, and the dots are non-interactive." }
+  },
+  "behavior": {
+    "inlineElement": "An inline element — `span` with `display: inline-flex` and intrinsic width. The component never paints layout opinion beyond its own dot row; centering under a pager (or any other placement) is a host binding, not a Pagination one.",
+    "decorative": "The root carries `aria-hidden='true'`. Dots reflect the host pager's position only; they are not buttons and tapping one does not scroll. The host MUST keep later pages reachable another way (natural tab order + scroll-into-view on focus) — see the carousel specs' `keyboardReach` rule.",
+    "hostOwnsIndex": "Pagination never observes scroll itself. The host derives `activeIndex` (typically IntersectionObserver at a ~60% threshold on its snap targets) and re-renders; the component just paints it, clamped to `0..count-1`.",
+    "minCount": "Renders nothing when `count` < 2. The host does not need its own conditional around the component."
+  },
+  "forbidden": [
+    "Dots rendered as interactive controls (button / link, tap-to-navigate) — that needs a focusable, labelled tab-like contract this family deliberately does not carry; if navigation chrome is required, use a different component",
+    "Active dot painted with a chromatic primary / accent / brand tone — the indicator is position chrome, not emphasis; active is `sys.color.onSurface`, full stop",
+    "Pagination used as a step / completion indicator for a linear task — that role is `progress`",
+    "Numeric page labels, counters, or arrows composed into the row — the family is the dot row only; numbered pagination is a different pattern",
+    "Rendering the row for a single page (`count` < 2) by bypassing the built-in guard — a one-page pager has no position to indicate",
+    "Row stretched to the host column (`width: 100%` / block display) to center the dots from inside — the component is an intrinsic-width inline element; centering is the host's binding"
+  ]
+}

package/agents/components/profile-header/profile-header.md

@@ -1,5 +1,7 @@
 # Profile header
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/profile-header/profile-header.md`](../../../i18n/ko/schema/components/profile-header/profile-header.md)
+
 Identity block at the top of a profile detail screen — a full-bleed cover band, an overlapping circular [Thumbnail](../thumbnail/thumbnail.md) avatar, an entity name, a visibility + follower meta row, and a trailing follow [Toggle Button](../button/toggle.md). Same `profile` contract as [Profile carousel](../carousel/profile.md) (channel topic, user, company channel) — the carousel surfaces a fixed-shape card in a curated rail; the header is the page-level identity rung the rail's `See all` lands on.
 
 **Reach for this when** a profile detail route opens on a followable entity that needs a cover, an avatar, a single page-level heading, and a follow affordance. **Skip when** the screen is a feed list (use [Navigation bar/home](../navigation-bar/main.md) + [Feed](../feed/feed.md)), a settings or account drill-in (use [Navigation bar/page](../navigation-bar/sub.md) + [Nav card](../nav-card/nav-card.md)), or a curated profile rail (use [Carousel](../carousel/carousel.md) + [Profile carousel](../carousel/profile.md)).

package/agents/components/progress/progress.md

@@ -1,5 +1,7 @@
 # Progress
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/progress/progress.md`](../../../i18n/ko/schema/components/progress/progress.md)
+
 A single visual rung — 8px tall, fully rounded — that previews how far a long-running task has advanced. Determinate only: a filled indicator parks at the value's ratio. No emphasis axis: track paints with `sys.color.scrimSubtle` (the translucent inverse-tone scrim — ~8% black light, ~8% white dark); indicator paints in `inverseSurface` so the filled segment contrasts against the track regardless of theme.
 
 **Reach for this when** a screen holds a task long enough that the user would otherwise wonder if anything is happening — file uploads, onboarding step counters, background syncs, account migrations. **Skip when** the task resolves under 300ms, the wait is purely opaque (use [Skeleton](../skeleton/skeleton.md) for content placeholders, busy spinners for short opaque waits), or the metric is primary content rather than chrome (use a chart).

package/agents/components/side-sheet/side-sheet.md

@@ -1,5 +1,7 @@
 # SideSheet
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/side-sheet/side-sheet.md`](../../../i18n/ko/schema/components/side-sheet/side-sheet.md)
+
 Off-canvas content column anchored to the leading or trailing edge of the viewport. Pairs with [BottomSheet](../bottom-sheet/bottom-sheet.md) as the Sheet family's other anchor — BottomSheet for committed-sheet flows, SideSheet for off-canvas navigation columns, settings panes, channel directories, filter rails.
 
 **Reach for this when** an off-canvas column belongs next to the current page — a navigation drawer, a channel / topic / saved-item directory, a filter rail, a settings pane. **Skip when** the surface is a committed-sheet flow (use [BottomSheet](../bottom-sheet/bottom-sheet.md)), a confirmation prompt (use [Dialog](../dialog/dialog.md)), a labelled in-flow block (use [Section](../section/section.md)), or a permanent app-shell navigation (use [TabBar](../tab-bar/tab-bar.md) / [NavigationBar](../navigation-bar/navigation-bar.md)).

package/agents/components/skeleton/skeleton.md

@@ -1,5 +1,7 @@
 # Skeleton
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/skeleton/skeleton.md`](../../../i18n/ko/schema/components/skeleton/skeleton.md)
+
 A tonal placeholder block that previews where real content will render. Paints with a translucent `scrimSubtle` overlay (~8% black in light mode, ~8% white in dark) and a slow opacity pulse — visible on every host surface tier without colliding with a fixed neutral step. Three shapes — `text` (default 16-line block), `block` (image / card body), `circle` (avatar). Compose multiple Skeletons inside `SkeletonGroup` to mirror the loading content's rhythm.
 
 **Reach for this when** a list row, feed post, card cover, or avatar is being fetched and the host would otherwise paint empty. **Skip when** the wait is sub-300ms, the data is unavailable rather than loading (use an empty-state illustration), or the loading scope is the whole screen (use a centered progress indicator at page level).

package/agents/components/status-tag/status-tag.md

@@ -1,5 +1,7 @@
 # Status tag
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/status-tag/status-tag.md`](../../../i18n/ko/schema/components/status-tag/status-tag.md)
+
 A small inline status pill — a tonal mark sized for the trailing edge of a row label. Two **appearances**: `neutral` (quiet informational default) and `error` (rejection / blocked). Decorative — never interactive.
 
 **Reach for this when** a row label needs a short state annotation inline — "pending" next to a user channel, "rejected" next to a failed approval, "draft" next to an in-progress post. **Skip when** the state is the row's primary content (use [List/standard](../list/standard.md) with `supportingText`), when the mark must be tappable (host row owns the click target), inside a chip row (use [chip/filter](../chip/filter.md) or [chip/tag](../chip/tag.md)), or when the mark names *who the person is* rather than a workflow state — 채널장 / 현직자 belong to [badge/role](../badge/role.md).

package/agents/components/suggestion-list/suggestion-list.md

@@ -1,5 +1,7 @@
 # Suggestion list
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/suggestion-list/suggestion-list.md`](../../../i18n/ko/schema/components/suggestion-list/suggestion-list.md)
+
 A vertically-stacked block of follow-able recommendations rendered as a swipeable pager. One page shows three [list/entry](../list/entry.md)-shaped rows at the `xlarge` rung (56px [Thumbnail](../thumbnail/thumbnail.md), label + stacked `secondary` followers + `description`, trailing [Toggle Button](../button/toggle.md)); the next page peeks at the trailing edge to invite the swipe. Anatomy is entity-agnostic — channels, people, companies, topics share one shape.
 
 **Reach for this when** a follow-able set is best surfaced as a peek of three with horizontal paging — recommended channels, people you may know, suggested companies. **Skip when** the full set should scan vertically with no pager (use [DirectoryList](../directory-list/directory-list.md)), the rail is a label-only nav strip ([AvatarRail](../avatar-rail/avatar-rail.md)), or the surface needs fixed-width profile cards ([Profile carousel](../carousel/profile.md)).

package/agents/components/switch/switch.md

@@ -1,5 +1,7 @@
 # Switch
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/switch/switch.md`](../../../i18n/ko/schema/components/switch/switch.md)
+
 A binary active/inactive control — a pill-shaped track with a circular thumb that translates between ends. **Inactive** reads as a `scrimSubtle` track with an `outlineVariant` hairline and a fixed-white thumb; **active** paints the track in `primary` so the contract reads chromatically without an inline label.
 
 **Reach for this when** a setting commits the moment it changes — notifications, privacy toggles, *show in feed*, instant-commit list trailing. **Skip when** the commit needs confirmation (use [Button](../button/button.md) + [Dialog](../dialog/dialog.md)), when the user picks one of several options ([List/radio](../list/radio.md), [Tabs](../tabs/tabs.md)), or when destructive — Switch carries no undo.

package/agents/components/tab-bar/tab-bar.md

@@ -1,5 +1,7 @@
 # Tab bar
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tab-bar/tab-bar.md`](../../../i18n/ko/schema/components/tab-bar/tab-bar.md)
+
 The bottom tab bar — a horizontal strip pinned to the bottom of the app exposing top-level destinations (Home / Company / Explore / Jobs / Notifications) in one tap. Each item stacks a 24px glyph above a 10/Regular label; active items show the filled companion glyph at `onSurface`, inactive render the outline at `onSurfaceVariant`. An item may opt into `appearance="primary"` to render a tile-shaped commit affordance — the conventional **Create** entry at the trailing end.
 
 **Reach for this when** you need persistent top-level navigation on a mobile-shaped viewport. **Skip when** the destinations belong inside a single surface — use [Tabs](../tabs/underline.md) — or when the chrome must float — use [FAB](../button/fab.md).

package/agents/components/tabs/rounded.md

@@ -1,5 +1,7 @@
 # Rounded
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tabs/rounded.md`](../../../i18n/ko/schema/components/tabs/rounded.md)
+
 Rounded-rectangle tab row — each tab a self-contained chip with a required leading icon and label. Shares chrome with [Segmented](./segmented.md) and [Filter chip](../chip/filter.md) verbatim; the single divergence is corner radius, which steps from `sys.radius.full` (capsule) to `sys.radius.md` (8) — reads as a soft rounded rectangle, not a pill.
 
 **Reach for this when** the row is a sort/filter switcher inside content. **Skip when** the row anchors content sections — use [Underline](./underline.md) — or when it's an in-place mode change — use [Segmented](./segmented.md).

package/agents/components/tabs/segmented.md

@@ -1,5 +1,7 @@
 # Segmented
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tabs/segmented.md`](../../../i18n/ko/schema/components/tabs/segmented.md)
+
 The inline view-mode toggle — a row of mutually-exclusive selectors for in-place mode changes (List ↔ Grid, Day ↔ Week ↔ Month).
 
 **Reach for this when** the segments swap the *same* content's view or range in place — List ↔ Grid, Day ↔ Week ↔ Month. **Skip when** segments switch between *different* panels ([Underline](./underline.md)), multiple values can co-select ([Filter chip](../chip/filter.md)), or the rung is a single-select picker over a long list ([Radio list](../list/radio.md)).

package/agents/components/tabs/tabs.md

@@ -1,5 +1,7 @@
 # Tabs
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tabs/tabs.md`](../../../i18n/ko/schema/components/tabs/tabs.md)
+
 A horizontal row of mutually-exclusive selections — exactly one tab is active, and selecting one swaps the surrounding panel. Sub-flavors: **Underline** is the canonical content-section switcher; **Segmented** is the inline view-mode toggle whose chrome delegates to [Filter chip](../chip/filter.md).
 
 **Layout inset.** `full-bleed` — sits as a direct child of the page shell (or any surface that pays the gutter) and stretches edge-to-edge inside it. The tabs rail pays its own internal padding via `layout.container.*`; do **not** wrap it in another `padding-inline` / `px-*` / `style={{ padding: … }}` div, or the page rail double-pays. Inside a bounded surface (Card / Dialog / BottomSheet / Sheet), apply the negative-margin opt-out — see [`AGENTS.md` § Composition rules](../../../AGENTS.md#composition-rules).

package/agents/components/tabs/underline.md

@@ -1,5 +1,7 @@
 # Underline
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tabs/underline.md`](../../../i18n/ko/schema/components/tabs/underline.md)
+
 The canonical content-section switcher — a row of tabs anchored above a panel, with a 2px `onSurface` indicator that slides along the active tab's bottom edge.
 
 **Reach for this when** moving between peer panels of the same surface. **Skip when** the row is an in-place mode change — use [Segmented](./segmented.md) instead.

package/agents/components/thumbnail/thumbnail.md

@@ -1,5 +1,7 @@
 # Thumbnail
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/thumbnail/thumbnail.md`](../../../i18n/ko/schema/components/thumbnail/thumbnail.md)
+
 A circular image — the unit that identifies a channel, a feed author, or any small-rung image. Two optional badges ride without changing footprint: an **update dot** top-right and a **logo badge** bottom-right. A pure visual primitive — no label of its own.
 
 **Reach for this when** the host needs to identify an entity at a glance — channel avatar in a list row, feed author block, AvatarRail item, NavigationBar leading. **Skip when** the surface is a labelled icon glyph (use [Icon Button](../button/icon.md)) or a sub-brand identity at fixed inline scale ([NavCard](../nav-card/nav-card.md)'s logo slot).

package/agents/components/toast/toast.md

@@ -1,5 +1,7 @@
 # Toast
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/toast/toast.md`](../../../i18n/ko/schema/components/toast/toast.md)
+
 A transient confirmation strip that floats above the page after a user action lands — saved, copied, sent, retried. Inverse-toned by default so the message contrasts with any underlying page tier; content-driven width up to a 400 cap.
 
 **Reach for this when** you need to confirm a system outcome the user just triggered — saved, copied, sent, retried. **Skip when** the message is contextual to the content itself (use [Banner](../banner/banner.md)), or the surface is a committed confirmation prompt (use [Dialog](../dialog/dialog.md)).

package/agents/components/tooltip/tooltip.md

@@ -1,5 +1,7 @@
 # Tooltip
 
+> 🇰🇷 한국어: [`i18n/ko/schema/components/tooltip/tooltip.md`](../../../i18n/ko/schema/components/tooltip/tooltip.md)
+
 A trigger-anchored explanation bubble — a small contrast-toned surface with a caret that points at the host. Reach for it to surface a label or short hint that does not fit on the trigger ("Manage" on an icon button, a coach-mark). Prefer [Banner](../banner/banner.md) when the message belongs inline in the reading flow, and [Toast](../toast/toast.md) when it confirms a recent user action.
 
 **Layout inset.** `bounded-surface` — popover shell anchored to a trigger element. Owns its outer padding and trigger-relative placement; not subject to the page shell's `layout.page.*` gutter. Mount via a portal at the document root and position relative to the trigger. See [`AGENTS.md` § Composition rules](../../../AGENTS.md#composition-rules).

package/agents/compose.md

@@ -17,7 +17,7 @@ The recipes below answer the five compositional situations every product surface
 | `sys.layout.page.lg` (24→40px) | Marketing / editorial / landing. |
 | `sys.layout.page.xl` (40→64px) | Showcase heroes only. |
 
-**Paid once at the page shell.** All **eleven full-bleed families** inherit it — `navigation-bar`, `profile-header`, `tab-bar`, `tabs`, `section`, `feed`, `list`, `accordion` (list sub), `suggestion-list`, `avatar-rail`, `chip` (group). Never re-pay `padding-inline` on the child. Inline cards (`banner`, `nav-card`) are NOT in this list — they don't claim the page rail themselves; the host (page shell at the top level, or another container when wrapped) pays their horizontal inset for them. See LOVABLE.md §A.4.
+**Paid once at the page shell.** All **thirteen full-bleed families** (`family.json#layoutInset` is authoritative) inherit it — `avatar-rail`, `carousel`, `directory-list`, `divider`, `feed`, `header`, `list`, `nav-list`, `navigation-bar`, `profile-header`, `suggestion-list`, `tab-bar`, `tabs` — plus the `feed-ad` (feed sub) and `accordion` (list sub) that inherit from their parent. Never re-pay `padding-inline` on the child. `chip` is `inline`, but a chip *group* (filter rail) is rail-responsible — place it like a full-bleed child (no padding wrapper). Inline cards (`banner`, `nav-card`) are NOT in this list — they don't claim the page rail themselves; the host (page shell at the top level, or another container when wrapped) pays their horizontal inset for them. See LOVABLE.md §A.4.
 
 ### Surface interior padding
 
@@ -142,7 +142,7 @@ DESIGN.md rules condensed to a single line each. Read as **immediate-reject** tr
 4. **Surface tier ≤ 2 levels per screen.** `surface` plus one `surface*Container` rung is the cap. A third nested surface tone reads muddy — promote one to a different family (Banner, Card, Section header) instead of layering.
 5. **Chip / pill / avatar radius is always `radius.full`.** A 4px-rounded "chip" is a card; pick one component. Likewise a 999-rounded "card" reads as a chip.
 6. **Banner role decides the fill.** Informational → `sys.color.primaryContainer`. Promotional → `sys.color.surfaceContainerLow` (with optional brand accent on the leading icon, *not* the background). Error notice → `sys.color.errorContainer`. **`brandContainer` is reserved for promotional tinted strips, not default banners.**
-7. **Page inset is paid once at the page shell.** Every `full-bleed` family (Header — both `<Header>` and `<SubHeader>` — List, Feed, FeedAd, Carousel, AvatarRail, Divider, DirectoryList, NavList, SuggestionList, ProfileHeader, Chip group, NavigationBar, TabBar, Tabs) stretches edge-to-edge and pays its own row inset internally — never wrap one in a padded container or pass it `padding-inline`, or it double-pays the rail and lands at a different margin than its siblings. `Banner` / `nav-card` are **inline** (host owns the inset), not full-bleed. See `family.json#layoutInset` — the authoritative per-family value.
+7. **Page inset is paid once at the page shell.** Every `full-bleed` family (AvatarRail, Carousel, DirectoryList, Divider, Feed — plus its FeedAd sub — Header (both `<Header>` and `<SubHeader>`), List — plus its accordion sub — NavList, NavigationBar, ProfileHeader, SuggestionList, TabBar, Tabs) stretches edge-to-edge and pays its own row inset internally — never wrap one in a padded container or pass it `padding-inline`, or it double-pays the rail and lands at a different margin than its siblings. `Banner` / `nav-card` are **inline** (host owns the inset), not full-bleed; `Chip` is **inline** too, but a chip *group* is rail-responsible — place it like a full-bleed child. See `family.json#layoutInset` — the authoritative per-family value.
 8. **Nesting tightens, never widens.** Parent `container.md` → child `container.sm` → grandchild `container.xs`. Inverting reads as compression, not hierarchy.
 9. **Spec slot grammar is closed.** If a slot is not declared in `spec.json#slots`, it does not exist. Do not synthesize new slots, do not pass `className` / `style` overrides.
 10. **FAB count ≤ 1 per screen.** Create is the single canonical commit — additional FABs dilute the affordance.
@@ -193,7 +193,7 @@ If a step has no good match — that's a **Chorus gap**, not a license to invent
 
 ## When you go custom (no Chorus family fits)
 
-The LEGO ladder didn't surface a fit and you've genuinely exhausted visual-reuse on the 13 `"open"` families — you're building a custom primitive (small hint card, inline annotation, narrow aside). **Component went flexible; tokens did not.** With no Chorus spec to deny you, every literal value you type is either a token resolution or a violation.
+The LEGO ladder didn't surface a fit and you've genuinely exhausted visual-reuse on the `"open"` families (count owned by LOVABLE §C / `family.json#visualReuse`) — you're building a custom primitive (small hint card, inline annotation, narrow aside). **Component went flexible; tokens did not.** With no Chorus spec to deny you, every literal value you type is either a token resolution or a violation.
 
 The drift shape this section guards: a custom div where `background` is a token (because color rules are well-internalized) but `gap`, `padding`, `fontSize`, `lineHeight`, `borderRadius` are raw px (because the "off-scale px" rule lives in prose, not in concrete examples). Five literals, five violations — *"I used the color token"* is not a partial pass.
 

package/agents/manifest.json

@@ -71,6 +71,7 @@
     { "family": "nav-list",       "root": "components/nav-list/nav-list.family.json" },
     { "family": "navigation-bar", "root": "components/navigation-bar/navigation-bar.family.json" },
     { "family": "page-shell",     "root": "components/page-shell/page-shell.family.json" },
+    { "family": "pagination",     "root": "components/pagination/pagination.family.json" },
     { "family": "profile-header", "root": "components/profile-header/profile-header.family.json" },
     { "family": "progress",       "root": "components/progress/progress.family.json" },
     { "family": "carousel",       "root": "components/carousel/carousel.family.json" },

package/agents/patterns/README.md

@@ -1,5 +1,7 @@
 # Patterns
 
+> 🇰🇷 한국어: [`i18n/ko/patterns/README.md`](../i18n/ko/patterns/README.md)
+
 Canonical visual references for Chorus. Each pattern pairs an **image board** (`<slug>.png`) with a spec note (`<slug>.md`) covering intent, layout, tokens, and components. Boards are grouped by *what the surface does* — each `.png` is a montage of representative screens so an agent can learn a category's recurring patterns and visuals at a glance.
 
 Schemas say *what is allowed*; patterns say *what good looks like*.

package/agents/patterns/actions.md

@@ -4,6 +4,8 @@ image: ./actions.png
 status: canonical
 ---
 
+> 🇰🇷 한국어: [`i18n/ko/patterns/actions.md`](../i18n/ko/patterns/actions.md)
+
 ## Intent
 
 Task-completion surfaces — the user supplies input and commits. Verification forms, keyword/post registration, service-agreement checklists, comment composition, job filter settings, and the home content-creation shortcuts. Each surface is keyboard-first and terminates in **one** high-emphasis primary commit (a full-width or trailing blue `button / standard`), with neutral escapes parked around it. Reach here for the anatomy of "fill something in, then commit it".

package/agents/patterns/browsing.md

@@ -4,6 +4,8 @@ image: ./browsing.png
 status: canonical
 ---
 
+> 🇰🇷 한국어: [`i18n/ko/patterns/browsing.md`](../i18n/ko/patterns/browsing.md)
+
 ## Intent
 
 Entity discovery and navigation — channel drawers, all/followed channel lists, Explore trending rails, search empty/suggestion states, and the company feed. Lists of entities (channels, companies, posts) are the spine; the per-row commit is **Follow / Unfollow** (`button / toggle`), and the **whole row is the nav click target**. Reach here for "browse a set of things and follow/open one".

package/agents/patterns/communications.md

@@ -4,6 +4,8 @@ image: ./communications.png
 status: canonical
 ---
 
+> 🇰🇷 한국어: [`i18n/ko/patterns/communications.md`](../i18n/ko/patterns/communications.md)
+
 ## Intent
 
 Authored content and engagement — posts, embedded polls, gated previews, comment threads, the channel picker for posting, and offer/poll compose. `feed` is the spine for content streams; `list / radio` carries poll options; compose surfaces commit via a Cancel/Post action bar. Reach here for "read, react to, or author a post or comment".