@opencxh/domain 1.235.0 → 1.238.0

package/dist/platform/document-parse.d.ts

@@ -0,0 +1,2 @@
+import { DocumentBlock } from './document-blocks';
+export declare function markdownToDocument(md: string): DocumentBlock[];

package/dist/platform/document-text.d.ts

@@ -0,0 +1,14 @@
+import { DocumentBlock } from './document-blocks';
+/**
+ * The document as plain text: what an embedding and a keyword search should see.
+ *
+ * Markdown and plain text are not the same job. `**Yealink**` embeds as three tokens where two of
+ * them are punctuation, a table's pipes are noise in a cosine, and a search for "reset" should
+ * match `## Reset` without the reader having typed a hash. So this strips the markers markdown put
+ * there and keeps the words they wrapped.
+ *
+ * Built on top of {@link documentToMarkdown} rather than beside it: one place decides what a block
+ * says and in which order, and a second walk over the union would drift from it on the first new
+ * block type.
+ */
+export declare function documentToText(blocks: DocumentBlock[], title?: string): string;

package/dist/platform/document-text.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/platform/locales.d.ts

@@ -0,0 +1,38 @@
+import { KbLocale } from '../entities/kb/types';
+/**
+ * Languages this platform can write in.
+ *
+ * Deliberately **not** the shell's UI locale list. That one is a hardcoded
+ * `['nl','en']` in `LocalizationManager`, and a customer publishing a German
+ * help centre has nothing to do with which language our own buttons are in.
+ *
+ * The labels are endonyms — a language names itself the same way whoever reads
+ * the picker. So this is a fixed map on purpose, and not the "never freeze
+ * labels at module load" case the design system warns about.
+ *
+ * In domain rather than in an app because several ends need the same answer: the language picker
+ * in the article editor, the writing assistant's system prompt, and — since documents grew a
+ * recipient language — the contact and company forms in `apps/crm`. Two copies would drift, and
+ * the way you would find out is a letter coming back in the wrong language.
+ *
+ * It lived in `entities/kb/` while the knowledge base was the only caller. The old names still
+ * work: `entities/kb/locales.ts` re-exports them.
+ */
+export interface LocaleOption {
+    code: KbLocale;
+    /** The language's own name, for a picker. */
+    label: string;
+    /** Its English name, for telling a model which language to write in. */
+    english: string;
+}
+export declare const LOCALES: LocaleOption[];
+/** The language's own name, or the bare code for one we do not list. */
+export declare function localeName(code: string): string;
+/**
+ * How to name this language to a model.
+ *
+ * A bare BCP-47 tag is a weak instruction — `"nl"` inside an otherwise English
+ * prompt is not enough to stop a model answering in English. Both names plus
+ * the tag leaves nothing to infer.
+ */
+export declare function localeInstruction(code: string): string;

package/dist/platform/locales.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.235.0",
+  "version": "1.238.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",