@oxy.so/services 12.5.0 → 12.6.0

package/lib/typescript/module/ui/components/followButtonAccessibility.d.ts

@@ -8,9 +8,14 @@
  * (OxyHQ/oxy#1375 item 22). The name now says the state, and who it is for
  * when the caller knows the handle.
  *
+ * The words follow the button's verb ("Joined @fediverse", hinted "Leaves
+ * @fediverse") and its language: every string is `@oxy.so/core`'s `follow.*`.
+ *
  * Pure, and kept apart from the components, so every state is pinned by a
  * table test rather than by a render that can only see one state at a time.
  */
+import type { Translate } from '../hooks/useI18n.js';
+import type { FollowLabels, FollowVerb } from './followLabels.js';
 export interface FollowButtonAccessibility {
     accessibilityLabel: string;
     accessibilityHint?: string;
@@ -27,13 +32,18 @@ export declare function formatHandle(username: string | undefined): string | und
  *   because a press does nothing until the write settles.
  * - Following: "Following @nate", hinted "Unfollows @nate", because pressing
  *   it unfollows, which the visible "Following" does not say.
+ *
+ * The name is the visible label (the caller's, when it passed `labels`) beside
+ * the handle; the checking line and the hint are the verb's.
  */
 export declare function describeFollowButton(input: {
     isKnown: boolean;
     isFollowing: boolean;
     isPending: boolean;
     username?: string;
-}): FollowButtonAccessibility;
+    verb: FollowVerb;
+    labels: Pick<FollowLabels, 'idle' | 'active'>;
+}, t: Translate): FollowButtonAccessibility;
 /**
  * The "Follow all" button. The labels are the caller's, since a starter pack
  * and a feed's member list word it differently; the hint carries the count.
@@ -44,5 +54,5 @@ export declare function describeFollowAllButton(input: {
     count: number;
     followAllLabel: string;
     followedAllLabel: string;
-}): FollowButtonAccessibility;
+}, t: Translate): FollowButtonAccessibility;
 //# sourceMappingURL=followButtonAccessibility.d.ts.map

package/lib/typescript/module/ui/components/followButtonAccessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followButtonAccessibility.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/followButtonAccessibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,yBAAyB,CAyB5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,yBAAyB,CAQ5B"}
+{"version":3,"file":"followButtonAccessibility.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/followButtonAccessibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IACL,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC/C,EACD,CAAC,EAAE,SAAS,GACX,yBAAyB,CAqB3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IACL,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,EACD,CAAC,EAAE,SAAS,GACX,yBAAyB,CAQ3B"}

package/lib/typescript/module/ui/components/followLabels.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The words on a follow button, for every verb the ecosystem uses.
+ *
+ * "Follow" is wrong for half the things an Oxy user can follow: you subscribe
+ * to a channel, you join a community, you watch a listing. Both follow buttons
+ * read their words here, translated through `@oxy.so/core`'s `follow.*`
+ * strings, so a verb reads the same — and in the same language — wherever it is
+ * drawn.
+ */
+/**
+ * The small vocabulary of verbs the ecosystem actually uses. An application
+ * whose verb is not here passes `labels` instead — the escape hatch exists so
+ * this union never has to grow to accommodate one product's wording.
+ */
+export type FollowVerb = 'follow' | 'subscribe' | 'join' | 'watch';
+export interface FollowLabels {
+    /** Not following yet. */
+    idle: string;
+    /** Following, and this application acts on it. */
+    active: string;
+    /** Asked, waiting for the other side to accept. */
+    pending: string;
+    /** Following globally, but switched off in this application. */
+    disabled: string;
+}
+/** The labels for `verb` in the current language, with the caller's `overrides` on top. */
+export declare function useFollowLabels(verb?: FollowVerb, overrides?: Partial<FollowLabels>): FollowLabels;
+//# sourceMappingURL=followLabels.d.ts.map

package/lib/typescript/module/ui/components/followLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followLabels.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/followLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,IAAI,GAAE,UAAqB,EAC3B,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,YAAY,CAYd"}

package/lib/typescript/module/ui/components/followRules.d.ts

@@ -5,10 +5,16 @@
  * application drawing its own affordance (a chip grid, a compact row) imports
  * them from here — through `@oxy.so/services/ui/client` — without paying for the
  * button's dropdown menu.
+ *
+ * The menu's words are `@oxy.so/core`'s `follow.*` strings, read through the
+ * caller's `t`; without one they are English.
  */
 import type { FollowApplicationMode } from '@oxy.so/contracts';
+import type { Translate } from '../hooks/useI18n.js';
+import type { FollowVerb } from './followLabels.js';
 /** A timed-follow choice offered in the menu. */
 export interface FollowDuration {
+    /** The duration as it reads inside a sentence: "24 hours", "a week". */
     label: string;
     seconds: number;
 }
@@ -39,15 +45,6 @@ export interface FollowMenuItem {
         type: 'unfollow';
     };
 }
-/**
- * Which choices exist, given the state.
- *
- * Pure and exported because this is the product decision, not a rendering
- * detail: a timed follow is only offered before following, turning it off here
- * is only offered while following, and NEITHER is offered before the server has
- * answered — every one of them addresses a relationship that does not exist
- * yet, so offering them mid-write would mean sending a guessed id.
- */
 /**
  * What the main button should do for the current state.
  *
@@ -59,13 +56,27 @@ export declare function resolveFollowPrimaryAction(input: {
     isFollowing: boolean;
     applicationMode: FollowApplicationMode;
 }): 'follow' | 'unfollow' | 'enable-here';
+/**
+ * Which choices exist, given the state.
+ *
+ * Pure and exported because this is the product decision, not a rendering
+ * detail: a timed follow is only offered before following, turning it off here
+ * is only offered while following, and NEITHER is offered before the server has
+ * answered — every one of them addresses a relationship that does not exist
+ * yet, so offering them mid-write would mean sending a guessed id.
+ */
 export declare function buildFollowMenuItems(input: {
     following: boolean;
     applicationMode: FollowApplicationMode;
     hasRelationship: boolean;
     isPending: boolean;
     durations: FollowDuration[] | false;
+    /** The button's idle label, which a timed choice starts with: "Follow for 24 hours". */
     idleVerb: string;
     applicationName: string;
+    /** Words the "everywhere" line with this verb: "Leave everywhere". Default `follow`. */
+    verb?: FollowVerb;
+    /** `useI18n().t`, for the menu in the app's language. Default English. */
+    t?: Translate;
 }): FollowMenuItem[];
 //# sourceMappingURL=followRules.d.ts.map

package/lib/typescript/module/ui/components/followRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followRules.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/followRules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,EACvE,OAAO,CAUR,CAAC;AAEF,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EACF;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAChE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,GACvB;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,GACxB;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,qBAAqB,CAAC;CACxC,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAIxC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,qBAAqB,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,cAAc,EAAE,CAuCnB"}
+{"version":3,"file":"followRules.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/followRules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAEjD,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,EACvE,OAAO,CAUR,CAAC;AAEF,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EACF;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAChE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,GACvB;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,GACxB;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,qBAAqB,CAAC;CACxC,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAIxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,qBAAqB,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACpC,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0EAA0E;IAC1E,CAAC,CAAC,EAAE,SAAS,CAAC;CACf,GAAG,cAAc,EAAE,CAwCnB"}

package/lib/typescript/module/ui/hooks/useI18n.d.ts

@@ -1,3 +1,5 @@
+/** `useI18n().t`: a key and its `{{placeholders}}` in, the current language's text out. */
+export type Translate = (key: string, vars?: Record<string, string | number>) => string;
 /**
  * Display copy for SDK surfaces.
  *
@@ -12,7 +14,7 @@
  * Anything that reads or mutates session state uses `useOxy()`, which throws.
  */
 export declare function useI18n(): {
-    t: (key: string, vars?: Record<string, string | number>) => string;
+    t: Translate;
     locale: string;
 };
 //# sourceMappingURL=useI18n.d.ts.map

package/lib/typescript/module/ui/hooks/useI18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useI18n.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO;aAWN,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;;EAI9D"}
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useI18n.ts"],"names":[],"mappings":"AAWA,2FAA2F;AAC3F,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAExF;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO;;;EActB"}

package/lib/typescript/module/ui/utils/deviceSessionTitle.d.ts

@@ -1,5 +1,5 @@
 import { type DeviceLinkedSession } from '@oxy.so/core';
-type Translate = (key: string, vars?: Record<string, string | number>) => string;
+import type { Translate } from '../hooks/useI18n.js';
 /**
  * The title of one row in "Sessions & devices".
  *
@@ -14,5 +14,4 @@ type Translate = (key: string, vars?: Record<string, string | number>) => string
  * response does carry. Never the string "undefined".
  */
 export declare function deviceSessionTitle(session: Pick<DeviceLinkedSession, 'deviceName' | 'isCurrent' | 'user'>, t: Translate): string;
-export {};
 //# sourceMappingURL=deviceSessionTitle.d.ts.map

package/lib/typescript/module/ui/utils/deviceSessionTitle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceSessionTitle.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/deviceSessionTitle.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjF,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,EACvE,CAAC,EAAE,SAAS,GACX,MAAM,CAQR"}
+{"version":3,"file":"deviceSessionTitle.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/deviceSessionTitle.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAkB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,EACvE,CAAC,EAAE,SAAS,GACX,MAAM,CAQR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "12.5.0",
+  "version": "12.6.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -160,7 +160,7 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@expo/app-integrity": "~58.0.2",
     "@expo/vector-icons": "^15.0.3",
-    "@oxy.so/core": "6.3.0",
+    "@oxy.so/core": "6.4.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^12.0.1",
     "@react-native/babel-preset": "^0.88.0",
@@ -210,12 +210,12 @@
     "expo-video": "~58.0.11"
   },
   "//@oxy.so/bloom": "Bloom 11.1.0 adds the shared grouped sections, usage card, subscription plans, frame appearance and overlay navigation APIs used by this SDK. First-party Bloom peers remain open above this tested minimum.",
-  "//@oxy.so/core": "Core 6.1.0 supplies `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove`, which the sign-in & security panels call, and their translations. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
+  "//@oxy.so/core": "Core 6.4.0 supplies the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
   "peerDependencies": {
     "@expo/app-integrity": ">=56.0.0 <59.0.0",
     "@expo/vector-icons": "^15.0.3",
     "@oxy.so/bloom": ">=11.1.0",
-    "@oxy.so/core": "^6.3.0",
+    "@oxy.so/core": "^6.4.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": ">=11.4.1 <13.0.0",
     "@tanstack/query-async-storage-persister": "^5.101",

package/src/index.ts

@@ -344,11 +344,8 @@ export {
   FOLLOW_ACTION_LEAVES_ACTIVE,
 } from './ui/components/followRules';
 export type { FollowDuration, FollowMenuItem } from './ui/components/followRules';
-export type {
-  FollowTargetButtonProps,
-  FollowVerb,
-  FollowLabels,
-} from './ui/components/FollowTargetButton';
+export type { FollowTargetButtonProps } from './ui/components/FollowTargetButton';
+export type { FollowVerb, FollowLabels } from './ui/components/followLabels';
 export { useFollowTarget } from './ui/hooks/useFollowTarget';
 export type { UseFollowTargetResult } from './ui/hooks/useFollowTarget';
 export {

package/src/ui/client.ts

@@ -23,12 +23,14 @@ export type { OxyAuthPromptProps } from './components/OxyAuthPrompt';
 export { LogoIcon } from './components/logo/LogoIcon';
 export { LogoText } from './components/logo/LogoText';
 export { default as FollowButton } from './components/FollowButton';
-export { FollowTargetButton } from './components/FollowTargetButton';
 export type {
-  FollowTargetButtonProps,
-  FollowVerb,
-  FollowLabels,
-} from './components/FollowTargetButton';
+  FollowButtonProps,
+  SingleFollowButtonProps,
+  MultiFollowButtonProps,
+} from './components/FollowButton';
+export { FollowTargetButton } from './components/FollowTargetButton';
+export type { FollowTargetButtonProps } from './components/FollowTargetButton';
+export type { FollowVerb, FollowLabels } from './components/followLabels';
 export { default as ProfileButton } from './components/ProfileButton';
 export type { ProfileButtonProps } from './components/ProfileButton';
 export { default as PeableButton } from './components/PeableButton';

package/src/ui/components/FollowButton.tsx

@@ -8,10 +8,9 @@ import { useFollow, useFollowForButton } from '../hooks/useFollow';
 import { useFollowStore } from '../stores/followStore';
 import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/core';
 import { useShallow } from 'zustand/react/shallow';
+import { useI18n } from '../hooks/useI18n';
 import { describeFollowAllButton, describeFollowButton } from './followButtonAccessibility';
-
-const DEFAULT_FOLLOW_ALL_LABEL = 'Follow all';
-const DEFAULT_FOLLOWED_ALL_LABEL = 'Following';
+import { type FollowLabels, type FollowVerb, useFollowLabels } from './followLabels';
 
 /** Props shared by both single- and multi-user follow modes. */
 interface FollowButtonBaseProps {
@@ -35,6 +34,16 @@ export interface SingleFollowButtonProps extends FollowButtonBaseProps {
    * still follows the state.
    */
   username?: string;
+  /**
+   * The word for following this account: a fediverse community reads
+   * "Join"/"Joined". Translated, like every default label here.
+   */
+  verb?: FollowVerb;
+  /**
+   * Overrides for a verb the vocabulary does not carry. This button shows
+   * `idle` and `active`; a user follow has no pending or switched-off state.
+   */
+  labels?: Partial<FollowLabels>;
   userIds?: never;
 }
 
@@ -42,7 +51,9 @@ export interface SingleFollowButtonProps extends FollowButtonBaseProps {
 export interface MultiFollowButtonProps extends FollowButtonBaseProps {
   userIds: string[];
   initiallyAllFollowing?: boolean;
+  /** Default: "Follow all", translated. */
   followAllLabel?: string;
+  /** Default: "Following", translated. */
   followedAllLabel?: string;
   onBulkFollow?: (result: BulkFollowResult) => void;
   onBulkUnfollow?: (result: BulkUnfollowResult) => void;
@@ -63,6 +74,8 @@ const FollowButtonInner = memo(function FollowButtonInner({
   oxyServices,
   initiallyFollowing,
   username,
+  verb = 'follow',
+  labels,
   size = 'md',
   onFollowChange,
   style,
@@ -71,6 +84,8 @@ const FollowButtonInner = memo(function FollowButtonInner({
   showLoadingState = true,
   preventParentActions = true,
 }: SingleFollowButtonProps & { oxyServices: OxyServices }) {
+  const { t } = useI18n();
+  const text = useFollowLabels(verb, labels);
   const { isFollowing, isKnown, isLoading, toggleFollow, resolveStatus } = useFollowForButton(
     userId,
     oxyServices,
@@ -91,10 +106,19 @@ const FollowButtonInner = memo(function FollowButtonInner({
         if (accepted) onFollowChange?.(!isFollowing);
       } catch (err: unknown) {
         const error = err instanceof Error ? err : new Error(String(err));
-        toast.error(error.message || 'Failed to update follow status');
+        toast.error(error.message || t('follow.errors.update'));
       }
     },
-    [disabled, isLoading, isKnown, toggleFollow, onFollowChange, isFollowing, preventParentActions],
+    [
+      disabled,
+      isLoading,
+      isKnown,
+      toggleFollow,
+      onFollowChange,
+      isFollowing,
+      preventParentActions,
+      t,
+    ],
   );
 
   // Enqueue a batched status fetch ONLY when the status is genuinely unknown
@@ -110,12 +134,10 @@ const FollowButtonInner = memo(function FollowButtonInner({
   const isBusy = isLoading || !isKnown;
   const showFollowing = isKnown && isFollowing;
   const showSpinner = showLoadingState && isBusy;
-  const { accessibilityLabel, accessibilityHint } = describeFollowButton({
-    isKnown,
-    isFollowing: showFollowing,
-    isPending: isLoading,
-    username,
-  });
+  const { accessibilityLabel, accessibilityHint } = describeFollowButton(
+    { isKnown, isFollowing: showFollowing, isPending: isLoading, username, verb, labels: text },
+    t,
+  );
 
   return (
     <BloomFollowButton
@@ -128,7 +150,8 @@ const FollowButtonInner = memo(function FollowButtonInner({
       disabled={disabled || isBusy}
       style={style}
       textStyle={textStyle}
-      label={isKnown || showSpinner ? 'Follow' : ''}
+      label={isKnown || showSpinner ? text.idle : ''}
+      followingLabel={text.active}
       accessibilityLabel={accessibilityLabel}
       accessibilityHint={accessibilityHint}
     />
@@ -139,8 +162,8 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
   userIds,
   initiallyAllFollowing = false,
   size = 'md',
-  followAllLabel = DEFAULT_FOLLOW_ALL_LABEL,
-  followedAllLabel = DEFAULT_FOLLOWED_ALL_LABEL,
+  followAllLabel: followAllLabelProp,
+  followedAllLabel: followedAllLabelProp,
   onFollowChange,
   onBulkFollow,
   onBulkUnfollow,
@@ -150,6 +173,9 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
   showLoadingState = true,
   preventParentActions = true,
 }: MultiFollowButtonProps) {
+  const { t } = useI18n();
+  const followAllLabel = followAllLabelProp ?? t('follow.all.idle');
+  const followedAllLabel = followedAllLabelProp ?? t('follow.verbs.follow.active');
   const follow = useFollow(userIds);
   const followAllUsers = 'followAllUsers' in follow ? follow.followAllUsers : undefined;
   const unfollowAllUsers = 'unfollowAllUsers' in follow ? follow.unfollowAllUsers : undefined;
@@ -209,7 +235,7 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
           onBulkUnfollow?.(result);
         } catch (err: unknown) {
           const error = err instanceof Error ? err : new Error(String(err));
-          toast.error(error.message || 'Failed to update follow status');
+          toast.error(error.message || t('follow.errors.update'));
         } finally {
           setIsSubmitting(false);
         }
@@ -236,7 +262,7 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
         onBulkFollow?.(result);
       } catch (err: unknown) {
         const error = err instanceof Error ? err : new Error(String(err));
-        toast.error(error.message || 'Failed to update follow status');
+        toast.error(error.message || t('follow.errors.update'));
       } finally {
         setIsSubmitting(false);
       }
@@ -251,17 +277,21 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
       onBulkFollow,
       onBulkUnfollow,
       preventParentActions,
+      t,
     ],
   );
 
   const showSpinner = showLoadingState && isLoading;
-  const { accessibilityLabel, accessibilityHint } = describeFollowAllButton({
-    allFollowing,
-    isPending: Boolean(isLoading),
-    count: userIds.length,
-    followAllLabel,
-    followedAllLabel,
-  });
+  const { accessibilityLabel, accessibilityHint } = describeFollowAllButton(
+    {
+      allFollowing,
+      isPending: Boolean(isLoading),
+      count: userIds.length,
+      followAllLabel,
+      followedAllLabel,
+    },
+    t,
+  );
 
   return (
     <BloomFollowButton

package/src/ui/components/FollowTargetButton.tsx

@@ -22,6 +22,8 @@
  * small vocabulary of defaults and a full override, rather than a lookup keyed
  * on kind — a kind→verb table in this package would need a release every time
  * an application invents a kind, which is exactly the coupling #809 removes.
+ * The vocabulary and its translated words live in `followLabels`, shared with
+ * `FollowButton`.
  *
  * ## Relationship to the legacy `FollowButton`
  *
@@ -58,55 +60,28 @@ import {
   type FollowDuration,
   type FollowMenuItem,
 } from './followRules';
-
-/**
- * The small vocabulary of verbs the ecosystem actually uses. An application
- * whose verb is not here passes `labels` instead — the escape hatch exists so
- * this union never has to grow to accommodate one product's wording.
- */
-export type FollowVerb = 'follow' | 'subscribe' | 'join' | 'watch';
-
-export interface FollowLabels {
-  /** Not following yet. */
-  idle: string;
-  /** Following, and this application acts on it. */
-  active: string;
-  /** Asked, waiting for the other side to accept. */
-  pending: string;
-  /** Following globally, but switched off in this application. */
-  disabled: string;
-}
-
-const VERB_LABELS: Record<FollowVerb, FollowLabels> = {
-  follow: { idle: 'Follow', active: 'Following', pending: 'Requested', disabled: 'Off here' },
-  subscribe: {
-    idle: 'Subscribe',
-    active: 'Subscribed',
-    pending: 'Requested',
-    disabled: 'Off here',
-  },
-  join: { idle: 'Join', active: 'Joined', pending: 'Requested', disabled: 'Off here' },
-  watch: { idle: 'Watch', active: 'Watching', pending: 'Requested', disabled: 'Off here' },
-};
+import { type FollowLabels, type FollowVerb, useFollowLabels } from './followLabels';
+import { useI18n } from '../hooks/useI18n';
 
 const HOUR = 60 * 60;
 
 /**
  * Defaults chosen for the cases a timed follow is actually for: a live event
  * tonight, a story running this week. Not a general-purpose duration picker —
- * an application that needs one passes its own.
+ * an application that needs one passes its own. Labels are catalog keys, read
+ * at render in the app's language.
  */
-const DEFAULT_DURATIONS: FollowDuration[] = [
-  { label: '24 hours', seconds: 24 * HOUR },
-  { label: '72 hours', seconds: 72 * HOUR },
-  { label: 'A week', seconds: 7 * 24 * HOUR },
-];
+const DEFAULT_DURATIONS = [
+  { key: 'follow.durations.day', seconds: 24 * HOUR },
+  { key: 'follow.durations.threeDays', seconds: 72 * HOUR },
+  { key: 'follow.durations.week', seconds: 7 * 24 * HOUR },
+] as const;
 
 export interface FollowTargetButtonProps {
   /** The registered target's id. Registration is separate — see the SDK. */
   targetId: string;
   verb?: FollowVerb;
-  /** Full override, for a verb the vocabulary above does not carry. */
+  /** Full override, for a verb the vocabulary does not carry. */
   labels?: Partial<FollowLabels>;
   size?: 'sm' | 'md' | 'lg';
   style?: StyleProp<ViewStyle>;
@@ -118,7 +93,8 @@ export interface FollowTargetButtonProps {
   showOptions?: boolean;
   /**
    * Offer timed follows. Pass `false` where a temporary follow makes no sense —
-   * a store you buy from, an account you know.
+   * a store you buy from, an account you know. Default: 24 hours, 72 hours and
+   * a week, translated.
    */
   durations?: FollowDuration[] | false;
   /**
@@ -156,7 +132,7 @@ export const FollowTargetButton = memo(function FollowTargetButton({
   style,
   disabled = false,
   showOptions = true,
-  durations = DEFAULT_DURATIONS,
+  durations,
   applicationName,
   initialStatus,
   onChange,
@@ -164,13 +140,18 @@ export const FollowTargetButton = memo(function FollowTargetButton({
   const { status, isFollowing, isUnknown, isPending, follow, unfollow, disableHere, enableHere } =
     useFollowTarget(targetId, { initialStatus });
 
+  const { t } = useI18n();
+  const text = useFollowLabels(verb, labels);
+
+  const timedChoices = useMemo<FollowDuration[] | false>(
+    () => durations ?? DEFAULT_DURATIONS.map(({ key, seconds }) => ({ label: t(key), seconds })),
+    [durations, t],
+  );
+
   const reportMutationFailure = useCallback(() => {
-    const message =
-      useFollowTargetStore.getState().errors[targetId] ?? 'Could not update follow status';
+    const message = useFollowTargetStore.getState().errors[targetId] ?? t('follow.errors.update');
     toast.error(message);
-  }, [targetId]);
-
-  const text = useMemo(() => ({ ...VERB_LABELS[verb], ...labels }), [verb, labels]);
+  }, [targetId, t]);
 
   const label = useMemo(() => {
     if (status.globalState === 'requested') return text.pending;
@@ -224,9 +205,9 @@ export const FollowTargetButton = memo(function FollowTargetButton({
       // The confirmation is the point: a follow that ends on its own is a
       // promise, and a user who does not see it made will not believe it.
       // Which is also why it must not appear when the promise was not made.
-      toast.success(`Following for ${durationLabel.toLowerCase()}`);
+      toast.success(t('follow.menu.forDuration', { label: text.active, duration: durationLabel }));
     },
-    [follow, onChange, reportMutationFailure],
+    [follow, onChange, reportMutationFailure, t, text.active],
   );
 
   const menuItems = useMemo(
@@ -236,18 +217,22 @@ export const FollowTargetButton = memo(function FollowTargetButton({
         applicationMode: status.applicationMode,
         hasRelationship: Boolean(status.relationshipId),
         isPending,
-        durations,
+        durations: timedChoices,
         idleVerb: text.idle,
-        applicationName: applicationName ?? 'this app',
+        applicationName: applicationName ?? t('follow.menu.thisApp'),
+        verb,
+        t,
       }),
     [
       isFollowing,
       status.applicationMode,
       status.relationshipId,
       isPending,
-      durations,
+      timedChoices,
       text.idle,
       applicationName,
+      verb,
+      t,
     ],
   );
 
@@ -304,6 +289,8 @@ export const FollowTargetButton = memo(function FollowTargetButton({
     return <View style={style}>{primary}</View>;
   }
 
+  const optionsLabel = t('follow.menu.options', { label });
+
   return (
     <View style={[{ flexDirection: 'row', alignItems: 'center', gap: 4 }, style]}>
       {primary}
@@ -321,11 +308,11 @@ export const FollowTargetButton = memo(function FollowTargetButton({
             size={size === 'lg' ? 'lg' : 'sm'}
             icon={<ChevronDown width={16} />}
             disabled={disabled || isUnknown}
-            accessibilityLabel={`${label} options`}
-            accessibilityHint="Opens follow options"
+            accessibilityLabel={optionsLabel}
+            accessibilityHint={t('follow.menu.optionsHint')}
           />
         </DropdownMenuTrigger>
-        <DropdownMenuContent label={`${label} options`}>
+        <DropdownMenuContent label={optionsLabel}>
           {menuItems.map((item) => (
             <DropdownMenuItem key={item.key} onPress={() => runItem(item)}>
               {item.label}

package/src/ui/components/OxyConsentScreen.tsx

@@ -27,7 +27,7 @@ import { Avatar } from '@oxy.so/bloom/avatar';
 import { Button, LinkButton } from '@oxy.so/bloom/button';
 import { Text } from '@oxy.so/bloom/typography';
 import { useTheme } from '@oxy.so/bloom/theme';
-import { useI18n } from '../hooks/useI18n';
+import { type Translate, useI18n } from '../hooks/useI18n';
 import { LogoIcon } from './logo/LogoIcon';
 
 /** The requesting application, resolved by the caller (never user-supplied raw). */
@@ -133,8 +133,6 @@ const SCOPE_LABEL_KEYS: Readonly<Record<string, string>> = {
   'federation:write': 'consent.scopes.federationWrite',
 };
 
-type Translate = ReturnType<typeof useI18n>['t'];
-
 /** One permission row of the "Permissions requested" list. */
 interface PermissionRow {
   /** Stable list key / testID suffix — the first scope that produced this row. */