@saykit/carbon 0.9.0 → 0.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 [![Coverage](https://codecov.io/gh/k0d13/saykit/graph/badge.svg?flag=integration-carbon)](https://codecov.io/gh/k0d13/saykit?flags%5B0%5D=integration-carbon)
 
-Registers a shared `Say` with your Carbon client, helps command and component classes expose translated metadata, and adds locale-aware `interaction.say` and `guild.say` properties.
+Registers a shared catalogue with your Carbon client, helps command and component classes expose translated metadata, and adds locale-aware `interaction.say` and `guild.say` properties.
 
 ## Install
 
@@ -17,12 +17,12 @@ pnpm add @saykit/carbon saykit @buape/carbon
 ```ts
 import { Client, Command, type CommandInteraction } from '@buape/carbon';
 import { SayPlugin, withSay } from '@saykit/carbon';
-import { type Say } from 'saykit';
-import say from './i18n.js';
+import { type Catalogue } from 'saykit';
+import catalogue from './i18n.js';
 
 class PingCommand extends withSay(Command) {
-  constructor(say: Say) {
-    super(say, (say) => ({
+  constructor(catalogue: Catalogue) {
+    super(catalogue, (say) => ({
       name: say`ping`,
       description: say`Ping the bot!`,
     }));
@@ -33,8 +33,8 @@ class PingCommand extends withSay(Command) {
   }
 }
 
-const client = new Client({/* options */}, { commands: [new PingCommand(say)] }, [
-  new SayPlugin(say),
+const client = new Client({/* options */}, { commands: [new PingCommand(catalogue)] }, [
+  new SayPlugin(catalogue),
 ]);
 ```
 

package/dist/index.d.mts

@@ -1,13 +1,9 @@
 import { APIInteraction, BaseCommand, BaseComponent, Modal, Plugin } from "@buape/carbon";
-import { Say } from "saykit";
-//#region src/constants.d.ts
-declare const kSay: unique symbol;
-//#endregion
+import { Catalogue, View } from "saykit";
 //#region src/extensions/base-interaction.d.ts
 declare module '@buape/carbon' {
   interface BaseInteraction<T extends APIInteraction> {
-    get say(): Say;
-    [kSay]: Say;
+    get say(): View;
   }
 }
 declare function applyBaseInteractionExtension(): () => void;
@@ -15,8 +11,7 @@ declare function applyBaseInteractionExtension(): () => void;
 //#region src/extensions/guild.d.ts
 declare module '@buape/carbon' {
   interface Guild {
-    get say(): Say;
-    [kSay]: Say;
+    get say(): View;
   }
 }
 declare function applyGuildExtension(): () => void;
@@ -29,10 +24,10 @@ type SayProps<T> = Pick<T, Extract<keyof T, Keys>>;
  * Enhances a {@link BaseCommand} subclass with support for localisation.
  *
  * @param Base Abstract command constructor to extend.
- * @returns A new constructor that accepts a {@link Say} instance, a
+ * @returns A new constructor that accepts a {@link Catalogue}, a
  * properties-mapping function, and the original constructor arguments.
  */
-declare function withSay<Args extends unknown[], Instance extends BaseCommand>(Base: AbstractConstructor<Args, Instance>): AbstractConstructor<[say: Say, properties: (say: Say) => SayProps<Instance>, ...args: Args], Instance & Partial<Record<Keys, unknown>>>;
+declare function withSay<Args extends unknown[], Instance extends BaseCommand>(Base: AbstractConstructor<Args, Instance>): AbstractConstructor<[catalogue: Catalogue, properties: (say: View) => SayProps<Instance>, ...args: Args], Instance & Partial<Record<Keys, unknown>>>;
 /**
  * Enhances a {@link BaseComponent} or {@link Modal} subclass with
  * support for localisation.
@@ -44,21 +39,21 @@ declare function withSay<Args extends unknown[], Instance extends BaseComponent
 //#endregion
 //#region src/plugin.d.ts
 /**
- * A Carbon plugin that provides a singleton {@link Say} instance.
+ * A Carbon plugin that provides a singleton {@link Catalogue}.
  *
- * `SayPlugin` registers a {@link Say} instance globally and
- * applies interaction and guild-level extensions so that commands and
- * other handlers can access localisation utilities directly.
+ * `SayPlugin` registers a {@link Catalogue} globally and applies interaction and
+ * guild-level extensions, so that commands and other handlers can reach a view
+ * for their own locale directly.
  *
  * @example
  * ```ts
- * const say = new Say({ ... });
- * const client = new Client({ ... }, { ... }, [new SayPlugin(say)]);
+ * const catalogue = createCatalogue({ ... });
+ * const client = new Client({ ... }, { ... }, [new SayPlugin(catalogue)]);
  * ```
  */
 declare class SayPlugin extends Plugin {
   id: string;
-  constructor(say: Say);
+  constructor(catalogue: Catalogue);
 }
 //#endregion
 export { SayPlugin, type applyBaseInteractionExtension, type applyGuildExtension, withSay };

package/dist/index.mjs

@@ -38,12 +38,12 @@ function withSay(Base) {
 }
 function createSayCommand(Base) {
 	class SayCommand extends Base {
-		constructor(say, properties, ...args) {
+		constructor(catalogue, properties, ...args) {
 			super(...args);
-			const options = combineCommandOptions(Array.from(say).reduce((acc, [s, l]) => {
-				acc[l] = properties(s);
+			const options = combineCommandOptions(Array.from(catalogue).reduce((acc, [locale, say]) => {
+				acc[locale] = properties(say);
 				return acc;
-			}, {}), say.locale);
+			}, {}), catalogue.locales[0]);
 			Object.assign(this, options);
 		}
 	}
@@ -65,12 +65,9 @@ const kSay = Symbol.for("saykit.say");
 //#region src/extensions/base-interaction.ts
 function applyBaseInteractionExtension() {
 	Object.defineProperty(BaseInteraction.prototype, "say", { get() {
-		const say = Reflect.get(globalThis, kSay);
-		if (!say) throw new Error("No `say` instance available");
-		this[kSay] ??= say.clone();
-		const locale = this[kSay].match([this.rawData.locale]);
-		this[kSay].activate(locale);
-		return this[kSay];
+		const catalogue = Reflect.get(globalThis, kSay);
+		if (!catalogue) throw new Error("No catalogue registered, add SayPlugin to your Carbon client");
+		return catalogue.locale(catalogue.match([this.rawData.locale]));
 	} });
 	return () => {
 		Object.defineProperty(BaseInteraction.prototype, "say", { value: void 0 });
@@ -80,12 +77,9 @@ function applyBaseInteractionExtension() {
 //#region src/extensions/guild.ts
 function applyGuildExtension() {
 	Object.defineProperty(Guild.prototype, "say", { get() {
-		const say = Reflect.get(globalThis, kSay);
-		if (!say) throw new Error("No `say` instance available");
-		this[kSay] ??= say.clone();
-		const locale = this[kSay].match([this.rawData.preferred_locale]);
-		this[kSay].activate(locale);
-		return this[kSay];
+		const catalogue = Reflect.get(globalThis, kSay);
+		if (!catalogue) throw new Error("No catalogue registered, add SayPlugin to your Carbon client");
+		return catalogue.locale(catalogue.match([this.rawData.preferred_locale]));
 	} });
 	return () => {
 		Object.defineProperty(Guild.prototype, "say", { value: void 0 });
@@ -95,9 +89,9 @@ function applyGuildExtension() {
 //#region src/plugin.ts
 var SayPlugin = class extends Plugin {
 	id = "saykit";
-	constructor(say) {
+	constructor(catalogue) {
 		super();
-		Reflect.set(globalThis, kSay, say);
+		Reflect.set(globalThis, kSay, catalogue);
 		applyBaseInteractionExtension();
 		applyGuildExtension();
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saykit/carbon",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Carbon Discord framework integration for saykit",
   "keywords": [
     "bot",
@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "@buape/carbon": "0.16.0",
-    "saykit": "^0.9.0"
+    "saykit": "^0.10.0"
   },
   "peerDependencies": {
     "@buape/carbon": "*",