@aparte/plugin-titler 0.16.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aparté
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @aparte/plugin-titler
+
+Auto-title conversations in [aparté](https://github.com/apartejs/aparte) with an
+[aparte-titler](https://apartejs.dev/models/titler/) model: 3 to 6 words picked out of the
+first message, in the browser, no API call. The model weighs 40 to 133 KB and titles in a few
+milliseconds.
+
+```bash
+npm install @aparte/plugin-titler @aparte/titler-latin
+```
+
+```ts
+import type { AparteConversationManager } from '@aparte/core';
+import { loadTitler } from '@aparte/titler-latin';   // 17 European languages, 133 KB
+import { setupTitler } from '@aparte/plugin-titler';
+
+declare const manager: AparteConversationManager;    // yours — the one the chat persists to
+setupTitler(manager, { titler: loadTitler });
+```
+
+`loadTitler` is called once, the first time a conversation needs a title — the model is not on
+the page's critical path. A `Titler` instance or a promise of one (`loadTitler()`) is accepted
+in the same place, and so is any object with `title(message, budget?)` of your own
+(`TitlerLike`). `budget` caps the number of words (the model's default is 6).
+
+`setupTitler` returns a teardown that gives the manager back the provider it had. For a manager
+built with the `titleProvider` option, `createTitleProvider(options)` is the provider alone:
+
+```ts
+import { AparteConversationManager, type AparteStorageAdapter } from '@aparte/core';
+import { loadTitler } from '@aparte/titler-latin';
+import { createTitleProvider } from '@aparte/plugin-titler';
+
+declare const adapter: AparteStorageAdapter;
+const manager = new AparteConversationManager(adapter, {
+    titleProvider: createTitleProvider({ titler: loadTitler, budget: 4 }),
+});
+```
+
+An empty answer or a failed load leaves the default title (the message as typed): a titler that
+fails never loses the message from the sidebar.
+
+Pick the model for your languages — `@aparte/titler-latin` (17 languages, 133 KB),
+`@aparte/titler-latin-mini` (the same 17, 96 KB), `@aparte/titler-efigsp` (en, fr, es, de, pt,
+it, 77 KB), or `@aparte/titler` with a single-language file (40 KB) from the
+[model repository](https://huggingface.co/apartejs/aparte-titler).
+
+> ESM-only. Part of the aparté monorepo. Try the model at [apartejs.dev/models/titler/#demo](https://apartejs.dev/models/titler/#demo).

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `@aparte/plugin-titler` — auto-title conversations with an aparte-titler model.
+ *
+ * Core titles a conversation from its first user message, and the default is the
+ * message as typed. This plugin replaces that default with the words an
+ * [aparte-titler](https://apartejs.dev/models/titler/) model picks out of it — 3 to 6
+ * words, in the browser, no API call — through the manager's title provider seam.
+ *
+ * ```ts
+ * import { loadTitler } from '@aparte/titler-latin';
+ * import { setupTitler } from '@aparte/plugin-titler';
+ *
+ * setupTitler(manager, { titler: loadTitler });
+ * ```
+ *
+ * The plugin loads nothing on its own: it calls the loader you hand it, once, the
+ * first time a title is needed. Any object with `title(message, budget?)` works — the
+ * runtime's `Titler`, or one of your own.
+ */
+import type { AparteConversationManager, AparteConversationTitleProvider } from '@aparte/core';
+/** What the plugin needs of a titler: `@aparte/titler`'s `Titler` has exactly this. */
+export interface TitlerLike {
+    /** The title: the `budget` best-scored words of the message, in message order. */
+    title(message: string, budget?: number): string;
+}
+export interface TitlerOptions {
+    /**
+     * The model: a `Titler`, a promise of one (`loadTitler()`), or a loader called
+     * once, when the first title is needed — the shape that keeps the model out of
+     * the page's critical path.
+     */
+    titler: TitlerLike | Promise<TitlerLike> | (() => TitlerLike | Promise<TitlerLike>);
+    /** Words to keep. Omitted, the model's own default applies (6). */
+    budget?: number;
+}
+/**
+ * The title provider alone — for a manager built with the `titleProvider` option, or
+ * to compose with another provider. The model is resolved once and cached.
+ */
+export declare function createTitleProvider(options: TitlerOptions): AparteConversationTitleProvider;
+/**
+ * Register the model as the manager's title provider. Returns a teardown that gives
+ * the manager back the provider it had — unless another one was set since, which is
+ * then left alone.
+ */
+export declare function setupTitler(manager: AparteConversationManager, options: TitlerOptions): () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/F,uFAAuF;AACvF,MAAM,WAAW,UAAU;IACvB,kFAAkF;IAClF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACpF,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,+BAA+B,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAOlG"}

package/dist/index.js

@@ -0,0 +1,24 @@
+function createTitleProvider(options) {
+  let loaded;
+  const model = () => {
+    loaded ??= Promise.resolve(typeof options.titler === "function" ? options.titler() : options.titler);
+    return loaded;
+  };
+  return async (text) => {
+    const titler = await model();
+    return options.budget === void 0 ? titler.title(text) : titler.title(text, options.budget);
+  };
+}
+function setupTitler(manager, options) {
+  const previous = manager.getTitleProvider();
+  const provider = createTitleProvider(options);
+  manager.setTitleProvider(provider);
+  return () => {
+    if (manager.getTitleProvider() === provider) manager.setTitleProvider(previous);
+  };
+}
+export {
+  createTitleProvider,
+  setupTitler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * `@aparte/plugin-titler` — auto-title conversations with an aparte-titler model.\n *\n * Core titles a conversation from its first user message, and the default is the\n * message as typed. This plugin replaces that default with the words an\n * [aparte-titler](https://apartejs.dev/models/titler/) model picks out of it — 3 to 6\n * words, in the browser, no API call — through the manager's title provider seam.\n *\n * ```ts\n * import { loadTitler } from '@aparte/titler-latin';\n * import { setupTitler } from '@aparte/plugin-titler';\n *\n * setupTitler(manager, { titler: loadTitler });\n * ```\n *\n * The plugin loads nothing on its own: it calls the loader you hand it, once, the\n * first time a title is needed. Any object with `title(message, budget?)` works — the\n * runtime's `Titler`, or one of your own.\n */\nimport type { AparteConversationManager, AparteConversationTitleProvider } from '@aparte/core';\n\n/** What the plugin needs of a titler: `@aparte/titler`'s `Titler` has exactly this. */\nexport interface TitlerLike {\n    /** The title: the `budget` best-scored words of the message, in message order. */\n    title(message: string, budget?: number): string;\n}\n\nexport interface TitlerOptions {\n    /**\n     * The model: a `Titler`, a promise of one (`loadTitler()`), or a loader called\n     * once, when the first title is needed — the shape that keeps the model out of\n     * the page's critical path.\n     */\n    titler: TitlerLike | Promise<TitlerLike> | (() => TitlerLike | Promise<TitlerLike>);\n    /** Words to keep. Omitted, the model's own default applies (6). */\n    budget?: number;\n}\n\n/**\n * The title provider alone — for a manager built with the `titleProvider` option, or\n * to compose with another provider. The model is resolved once and cached.\n */\nexport function createTitleProvider(options: TitlerOptions): AparteConversationTitleProvider {\n    let loaded: Promise<TitlerLike> | undefined;\n    const model = (): Promise<TitlerLike> => {\n        loaded ??= Promise.resolve(typeof options.titler === 'function' ? options.titler() : options.titler);\n        return loaded;\n    };\n    return async (text) => {\n        const titler = await model();\n        return options.budget === undefined ? titler.title(text) : titler.title(text, options.budget);\n    };\n}\n\n/**\n * Register the model as the manager's title provider. Returns a teardown that gives\n * the manager back the provider it had — unless another one was set since, which is\n * then left alone.\n */\nexport function setupTitler(manager: AparteConversationManager, options: TitlerOptions): () => void {\n    const previous = manager.getTitleProvider();\n    const provider = createTitleProvider(options);\n    manager.setTitleProvider(provider);\n    return () => {\n        if (manager.getTitleProvider() === provider) manager.setTitleProvider(previous);\n    };\n}\n"],"names":[],"mappings":"AA0CO,SAAS,oBAAoB,SAAyD;AACzF,MAAI;AACJ,QAAM,QAAQ,MAA2B;AACrC,eAAW,QAAQ,QAAQ,OAAO,QAAQ,WAAW,aAAa,QAAQ,WAAW,QAAQ,MAAM;AACnG,WAAO;AAAA,EACX;AACA,SAAO,OAAO,SAAS;AACnB,UAAM,SAAS,MAAM,MAAA;AACrB,WAAO,QAAQ,WAAW,SAAY,OAAO,MAAM,IAAI,IAAI,OAAO,MAAM,MAAM,QAAQ,MAAM;AAAA,EAChG;AACJ;AAOO,SAAS,YAAY,SAAoC,SAAoC;AAChG,QAAM,WAAW,QAAQ,iBAAA;AACzB,QAAM,WAAW,oBAAoB,OAAO;AAC5C,UAAQ,iBAAiB,QAAQ;AACjC,SAAO,MAAM;AACT,QAAI,QAAQ,iBAAA,MAAuB,SAAU,SAAQ,iBAAiB,QAAQ;AAAA,EAClF;AACJ;"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@aparte/plugin-titler",
+  "version": "0.16.10",
+  "homepage": "https://apartejs.dev/plugins/titler/",
+  "description": "Auto-title conversations with an aparte-titler model — 3 to 6 words of the first message, in the browser, no API call.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "@aparte-workspace/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@aparte/core": ">=0.16.10 <1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vite": "^6.0.0",
+    "@aparte/core": "0.16.10"
+  },
+  "keywords": [
+    "aparte",
+    "plugin",
+    "titler",
+    "conversation-title",
+    "tiny-model",
+    "offline"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/apartejs/aparte.git",
+    "directory": "packages/plugins/titler"
+  },
+  "bugs": {
+    "url": "https://github.com/apartejs/aparte/issues"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc -b --emitDeclarationOnly --force",
+    "preview": "vite preview",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}