@fieldia/chatter 0.8.0

package/src/lib/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/memory.ts"],"names":[],"mappings":"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"}

package/src/lib/mentions.d.mts

@@ -0,0 +1,18 @@
+import type { ChatterContext } from './chatter.mjs';
+import type { Person } from './source.mjs';
+/** What is being typed after an @, up to the cursor; null when the cursor is not in one. */
+export declare function mentionAt(text: string, caret: number): {
+    start: number;
+    query: string;
+} | null;
+/**
+ * @mentions in a composer's box: people suggested as a name is typed after an
+ * @, picked with the arrows and Enter (or a click), and kept as long as their
+ * "@Name" is still in the text. Without a source of people, nothing happens.
+ */
+export declare function mentions(context: ChatterContext, box: HTMLTextAreaElement): {
+    list: HTMLUListElement;
+    /** The people still mentioned in the text. */
+    picked: () => Person[];
+    reset(): void;
+};

package/src/lib/mentions.d.ts

@@ -0,0 +1,18 @@
+import type { ChatterContext } from './chatter';
+import type { Person } from './source';
+/** What is being typed after an @, up to the cursor; null when the cursor is not in one. */
+export declare function mentionAt(text: string, caret: number): {
+    start: number;
+    query: string;
+} | null;
+/**
+ * @mentions in a composer's box: people suggested as a name is typed after an
+ * @, picked with the arrows and Enter (or a click), and kept as long as their
+ * "@Name" is still in the text. Without a source of people, nothing happens.
+ */
+export declare function mentions(context: ChatterContext, box: HTMLTextAreaElement): {
+    list: HTMLUListElement;
+    /** The people still mentioned in the text. */
+    picked: () => Person[];
+    reset(): void;
+};

package/src/lib/mentions.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mentionAt = mentionAt;
+exports.mentions = mentions;
+/** What is being typed after an @, up to the cursor; null when the cursor is not in one. */
+function mentionAt(text, caret) {
+    const before = text.slice(0, caret);
+    const match = /(?:^|\s)@([\p{L}\p{N}._-]*)$/u.exec(before);
+    return match ? { start: caret - match[1].length - 1, query: match[1] } : null;
+}
+/**
+ * @mentions in a composer's box: people suggested as a name is typed after an
+ * @, picked with the arrows and Enter (or a click), and kept as long as their
+ * "@Name" is still in the text. Without a source of people, nothing happens.
+ */
+function mentions(context, box) {
+    const { el, labels, source } = context;
+    const list = el('ul', { class: 'fd-mentions', role: 'listbox', hidden: '', 'aria-label': labels.search });
+    let picked = [];
+    let found = [];
+    let active = 0;
+    let asking = 0;
+    const close = () => {
+        list.hidden = true;
+        found = [];
+        box.removeAttribute('aria-activedescendant');
+    };
+    function draw() {
+        list.replaceChildren(...(found.length
+            ? found.map((person, i) => {
+                const option = el('li', { role: 'option', id: `fd-mention-${i}`, 'aria-selected': String(i === active), class: i === active ? 'fd-active' : '' }, person.name);
+                option.addEventListener('mousedown', (event) => event.preventDefault()); // the box keeps the focus
+                option.addEventListener('click', () => pick(person));
+                return option;
+            })
+            : [el('li', { class: 'fd-empty' }, labels.noOneFound)]));
+        list.hidden = false;
+    }
+    function pick(person) {
+        const at = mentionAt(box.value, box.selectionStart ?? box.value.length);
+        if (!at)
+            return close();
+        const inserted = `@${person.name} `;
+        box.value = box.value.slice(0, at.start) + inserted + box.value.slice(box.selectionStart ?? box.value.length);
+        const caret = at.start + inserted.length;
+        box.setSelectionRange(caret, caret);
+        if (!picked.some((p) => p.id === person.id))
+            picked.push(person);
+        close();
+        box.focus();
+    }
+    box.addEventListener('input', async () => {
+        const at = source.people ? mentionAt(box.value, box.selectionStart ?? box.value.length) : null;
+        if (!at || !source.people)
+            return close();
+        const mine = ++asking;
+        const people = await source.people(at.query);
+        if (mine !== asking)
+            return; // a newer question is on its way
+        found = people.slice(0, 8);
+        active = 0;
+        draw();
+    });
+    box.addEventListener('keydown', (event) => {
+        if (list.hidden || !found.length)
+            return;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            event.preventDefault();
+            active = (active + (event.key === 'ArrowDown' ? 1 : -1) + found.length) % found.length;
+            draw();
+            box.setAttribute('aria-activedescendant', `fd-mention-${active}`);
+        }
+        else if ((event.key === 'Enter' && !event.ctrlKey && !event.metaKey) || event.key === 'Tab') {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            pick(found[active]);
+        }
+        else if (event.key === 'Escape') {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            close();
+        }
+    });
+    return {
+        list,
+        /** The people still mentioned in the text. */
+        picked: () => picked.filter((person) => box.value.includes(`@${person.name}`)),
+        reset() {
+            picked = [];
+            close();
+        },
+    };
+}
+//# sourceMappingURL=mentions.js.map

package/src/lib/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/mentions.ts"],"names":[],"mappings":"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"}

package/src/lib/mentions.mjs

@@ -0,0 +1,90 @@
+/** What is being typed after an @, up to the cursor; null when the cursor is not in one. */
+export function mentionAt(text, caret) {
+    const before = text.slice(0, caret);
+    const match = /(?:^|\s)@([\p{L}\p{N}._-]*)$/u.exec(before);
+    return match ? { start: caret - match[1].length - 1, query: match[1] } : null;
+}
+/**
+ * @mentions in a composer's box: people suggested as a name is typed after an
+ * @, picked with the arrows and Enter (or a click), and kept as long as their
+ * "@Name" is still in the text. Without a source of people, nothing happens.
+ */
+export function mentions(context, box) {
+    const { el, labels, source } = context;
+    const list = el('ul', { class: 'fd-mentions', role: 'listbox', hidden: '', 'aria-label': labels.search });
+    let picked = [];
+    let found = [];
+    let active = 0;
+    let asking = 0;
+    const close = () => {
+        list.hidden = true;
+        found = [];
+        box.removeAttribute('aria-activedescendant');
+    };
+    function draw() {
+        list.replaceChildren(...(found.length
+            ? found.map((person, i) => {
+                const option = el('li', { role: 'option', id: `fd-mention-${i}`, 'aria-selected': String(i === active), class: i === active ? 'fd-active' : '' }, person.name);
+                option.addEventListener('mousedown', (event) => event.preventDefault()); // the box keeps the focus
+                option.addEventListener('click', () => pick(person));
+                return option;
+            })
+            : [el('li', { class: 'fd-empty' }, labels.noOneFound)]));
+        list.hidden = false;
+    }
+    function pick(person) {
+        const at = mentionAt(box.value, box.selectionStart ?? box.value.length);
+        if (!at)
+            return close();
+        const inserted = `@${person.name} `;
+        box.value = box.value.slice(0, at.start) + inserted + box.value.slice(box.selectionStart ?? box.value.length);
+        const caret = at.start + inserted.length;
+        box.setSelectionRange(caret, caret);
+        if (!picked.some((p) => p.id === person.id))
+            picked.push(person);
+        close();
+        box.focus();
+    }
+    box.addEventListener('input', async () => {
+        const at = source.people ? mentionAt(box.value, box.selectionStart ?? box.value.length) : null;
+        if (!at || !source.people)
+            return close();
+        const mine = ++asking;
+        const people = await source.people(at.query);
+        if (mine !== asking)
+            return; // a newer question is on its way
+        found = people.slice(0, 8);
+        active = 0;
+        draw();
+    });
+    box.addEventListener('keydown', (event) => {
+        if (list.hidden || !found.length)
+            return;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            event.preventDefault();
+            active = (active + (event.key === 'ArrowDown' ? 1 : -1) + found.length) % found.length;
+            draw();
+            box.setAttribute('aria-activedescendant', `fd-mention-${active}`);
+        }
+        else if ((event.key === 'Enter' && !event.ctrlKey && !event.metaKey) || event.key === 'Tab') {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            pick(found[active]);
+        }
+        else if (event.key === 'Escape') {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            close();
+        }
+    });
+    return {
+        list,
+        /** The people still mentioned in the text. */
+        picked: () => picked.filter((person) => box.value.includes(`@${person.name}`)),
+        reset() {
+            picked = [];
+            close();
+        },
+    };
+}
+//# sourceMappingURL=mentions.mjs.map

package/src/lib/mentions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.mjs","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/mentions.ts"],"names":[],"mappings":"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"}

package/src/lib/reactions.d.mts

@@ -0,0 +1,10 @@
+import type { ChatterContext } from './chatter.mjs';
+import type { ChatterId, Reaction } from './source.mjs';
+/** The reactions offered at a click: the ones teams use most. */
+export declare const REACTION_CHOICES: string[];
+/**
+ * A message's reactions: a chip for each, pressed when the person's own is
+ * among them and toggled by a click, and a button that offers the others.
+ * Nothing is shown when the source cannot keep reactions.
+ */
+export declare function reactionBar(context: ChatterContext, messageId: ChatterId, reactions: readonly Reaction[]): HTMLElement | null;

package/src/lib/reactions.d.ts

@@ -0,0 +1,10 @@
+import type { ChatterContext } from './chatter';
+import type { ChatterId, Reaction } from './source';
+/** The reactions offered at a click: the ones teams use most. */
+export declare const REACTION_CHOICES: string[];
+/**
+ * A message's reactions: a chip for each, pressed when the person's own is
+ * among them and toggled by a click, and a button that offers the others.
+ * Nothing is shown when the source cannot keep reactions.
+ */
+export declare function reactionBar(context: ChatterContext, messageId: ChatterId, reactions: readonly Reaction[]): HTMLElement | null;

package/src/lib/reactions.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACTION_CHOICES = void 0;
+exports.reactionBar = reactionBar;
+/** The reactions offered at a click: the ones teams use most. */
+exports.REACTION_CHOICES = ['👍', '❤️', '😄', '🎉', '👀', '✅'];
+/**
+ * A message's reactions: a chip for each, pressed when the person's own is
+ * among them and toggled by a click, and a button that offers the others.
+ * Nothing is shown when the source cannot keep reactions.
+ */
+function reactionBar(context, messageId, reactions) {
+    const { el, labels, source } = context;
+    if (!source.react)
+        return null;
+    const react = source.react.bind(source);
+    const bar = el('div', { class: 'fd-reactions' });
+    const picker = el('div', { class: 'fd-reaction-picker', hidden: '', role: 'group', 'aria-label': labels.react });
+    const toggle = async (emoji) => {
+        const record = context.record();
+        if (!record)
+            return;
+        picker.hidden = true;
+        draw(await react(record, messageId, emoji));
+    };
+    for (const emoji of exports.REACTION_CHOICES) {
+        const choice = el('button', { type: 'button', 'data-emoji': emoji, 'aria-label': emoji }, emoji);
+        choice.addEventListener('click', () => void toggle(emoji));
+        picker.append(choice);
+    }
+    const add = el('button', { type: 'button', class: 'fd-reaction-add', 'aria-label': labels.react, 'aria-expanded': 'false' }, '☺');
+    add.addEventListener('click', () => {
+        picker.hidden = !picker.hidden;
+        add.setAttribute('aria-expanded', String(!picker.hidden));
+    });
+    picker.addEventListener('keydown', (event) => {
+        if (event.key === 'Escape') {
+            picker.hidden = true;
+            add.focus();
+        }
+    });
+    function draw(list) {
+        const chips = list.map((reaction) => {
+            const chip = el('button', { type: 'button', class: 'fd-reaction', 'aria-pressed': String(reaction.mine) }, `${reaction.emoji} ${reaction.count}`);
+            chip.addEventListener('click', () => void toggle(reaction.emoji));
+            return chip;
+        });
+        bar.replaceChildren(...chips, add, picker);
+    }
+    draw(reactions);
+    return bar;
+}
+//# sourceMappingURL=reactions.js.map

package/src/lib/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/reactions.ts"],"names":[],"mappings":"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"}

package/src/lib/reactions.mjs

@@ -0,0 +1,49 @@
+/** The reactions offered at a click: the ones teams use most. */
+export const REACTION_CHOICES = ['👍', '❤️', '😄', '🎉', '👀', '✅'];
+/**
+ * A message's reactions: a chip for each, pressed when the person's own is
+ * among them and toggled by a click, and a button that offers the others.
+ * Nothing is shown when the source cannot keep reactions.
+ */
+export function reactionBar(context, messageId, reactions) {
+    const { el, labels, source } = context;
+    if (!source.react)
+        return null;
+    const react = source.react.bind(source);
+    const bar = el('div', { class: 'fd-reactions' });
+    const picker = el('div', { class: 'fd-reaction-picker', hidden: '', role: 'group', 'aria-label': labels.react });
+    const toggle = async (emoji) => {
+        const record = context.record();
+        if (!record)
+            return;
+        picker.hidden = true;
+        draw(await react(record, messageId, emoji));
+    };
+    for (const emoji of REACTION_CHOICES) {
+        const choice = el('button', { type: 'button', 'data-emoji': emoji, 'aria-label': emoji }, emoji);
+        choice.addEventListener('click', () => void toggle(emoji));
+        picker.append(choice);
+    }
+    const add = el('button', { type: 'button', class: 'fd-reaction-add', 'aria-label': labels.react, 'aria-expanded': 'false' }, '☺');
+    add.addEventListener('click', () => {
+        picker.hidden = !picker.hidden;
+        add.setAttribute('aria-expanded', String(!picker.hidden));
+    });
+    picker.addEventListener('keydown', (event) => {
+        if (event.key === 'Escape') {
+            picker.hidden = true;
+            add.focus();
+        }
+    });
+    function draw(list) {
+        const chips = list.map((reaction) => {
+            const chip = el('button', { type: 'button', class: 'fd-reaction', 'aria-pressed': String(reaction.mine) }, `${reaction.emoji} ${reaction.count}`);
+            chip.addEventListener('click', () => void toggle(reaction.emoji));
+            return chip;
+        });
+        bar.replaceChildren(...chips, add, picker);
+    }
+    draw(reactions);
+    return bar;
+}
+//# sourceMappingURL=reactions.mjs.map

package/src/lib/reactions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.mjs","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/reactions.ts"],"names":[],"mappings":"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"}

package/src/lib/slot.d.mts

@@ -0,0 +1,17 @@
+import type { Form } from '@fieldia/core';
+import { type ChatterOptions } from './chatter.mjs';
+export interface ChatterSlotOptions extends Omit<ChatterOptions, 'record'> {
+    /** The model the conversation is about; the page's own by default. */
+    model?: string;
+}
+/**
+ * What fills a sheet's chatter slot: the conversation of the record the form
+ * shows. It waits while the record is new, starts once it is saved, follows
+ * the form to another record, and fetches again after each save, when a
+ * backend posts what changed.
+ *
+ *   mountViewer(host, { page, dataSource, slots: { chatter: chatterSlot({ source }) } })
+ */
+export declare function chatterSlot(options: ChatterSlotOptions): (element: HTMLElement, context: {
+    form: Form;
+}) => () => void;

package/src/lib/slot.d.ts

@@ -0,0 +1,17 @@
+import type { Form } from '@fieldia/core';
+import { type ChatterOptions } from './chatter';
+export interface ChatterSlotOptions extends Omit<ChatterOptions, 'record'> {
+    /** The model the conversation is about; the page's own by default. */
+    model?: string;
+}
+/**
+ * What fills a sheet's chatter slot: the conversation of the record the form
+ * shows. It waits while the record is new, starts once it is saved, follows
+ * the form to another record, and fetches again after each save, when a
+ * backend posts what changed.
+ *
+ *   mountViewer(host, { page, dataSource, slots: { chatter: chatterSlot({ source }) } })
+ */
+export declare function chatterSlot(options: ChatterSlotOptions): (element: HTMLElement, context: {
+    form: Form;
+}) => () => void;

package/src/lib/slot.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatterSlot = chatterSlot;
+const chatter_1 = require("./chatter");
+/**
+ * What fills a sheet's chatter slot: the conversation of the record the form
+ * shows. It waits while the record is new, starts once it is saved, follows
+ * the form to another record, and fetches again after each save, when a
+ * backend posts what changed.
+ *
+ *   mountViewer(host, { page, dataSource, slots: { chatter: chatterSlot({ source }) } })
+ */
+function chatterSlot(options) {
+    return (element, { form }) => {
+        const model = options.model ?? (form.page.data.kind === 'record' ? form.page.data.model : null);
+        const recordOf = (state) => (model && state.recordId != null ? { model, id: state.recordId } : null);
+        let shown = recordOf(form.getState());
+        let status = form.getState().status;
+        const chatter = (0, chatter_1.mountChatter)(element, { ...options, record: shown });
+        const unsubscribe = form.subscribe((state) => {
+            const next = recordOf(state);
+            if (next?.id !== shown?.id) {
+                shown = next;
+                void chatter.setRecord(next);
+            }
+            else if (state.status === 'saved' && status !== 'saved') {
+                void chatter.refresh();
+            }
+            status = state.status;
+        });
+        return () => {
+            unsubscribe();
+            chatter.destroy();
+        };
+    };
+}
+//# sourceMappingURL=slot.js.map

package/src/lib/slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/slot.ts"],"names":[],"mappings":";;AAiBA,kCAsBC;AAtCD,uCAA8D;AAQ9D;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,OAA2B;IACrD,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClI,IAAI,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;QACpC,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,IAAI,EAAE,EAAE,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC;gBAC3B,KAAK,GAAG,IAAI,CAAC;gBACb,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC1D,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/slot.mjs

@@ -0,0 +1,34 @@
+import { mountChatter } from './chatter.mjs';
+/**
+ * What fills a sheet's chatter slot: the conversation of the record the form
+ * shows. It waits while the record is new, starts once it is saved, follows
+ * the form to another record, and fetches again after each save, when a
+ * backend posts what changed.
+ *
+ *   mountViewer(host, { page, dataSource, slots: { chatter: chatterSlot({ source }) } })
+ */
+export function chatterSlot(options) {
+    return (element, { form }) => {
+        const model = options.model ?? (form.page.data.kind === 'record' ? form.page.data.model : null);
+        const recordOf = (state) => (model && state.recordId != null ? { model, id: state.recordId } : null);
+        let shown = recordOf(form.getState());
+        let status = form.getState().status;
+        const chatter = mountChatter(element, { ...options, record: shown });
+        const unsubscribe = form.subscribe((state) => {
+            const next = recordOf(state);
+            if (next?.id !== shown?.id) {
+                shown = next;
+                void chatter.setRecord(next);
+            }
+            else if (state.status === 'saved' && status !== 'saved') {
+                void chatter.refresh();
+            }
+            status = state.status;
+        });
+        return () => {
+            unsubscribe();
+            chatter.destroy();
+        };
+    };
+}
+//# sourceMappingURL=slot.mjs.map

package/src/lib/slot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.mjs","sourceRoot":"","sources":["../../../../../libs/chatter/src/lib/slot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,WAAW,CAAC;AAQ9D;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClI,IAAI,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;QACpC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,IAAI,EAAE,EAAE,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC;gBAC3B,KAAK,GAAG,IAAI,CAAC;gBACb,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC1D,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/source.d.mts

@@ -0,0 +1,114 @@
+/**
+ * How the chatter reaches the server: an object the app writes for its own
+ * backend, as it writes a data source. Reading and posting messages are all a
+ * chatter needs; each other method adds a part (uploads, reactions, mentions,
+ * activities, followers), and a part whose method is missing is not shown.
+ */
+export type ChatterId = string | number;
+/** The record the conversation is about. */
+export interface RecordRef {
+    model: string;
+    id: ChatterId;
+}
+export interface Person {
+    id: ChatterId;
+    name: string;
+    /** An image address; without one, the person's initials stand in. */
+    avatar?: string | null;
+}
+export interface Attachment {
+    id: ChatterId;
+    name: string;
+    /** Its media type, such as `image/png`: an image gets a preview. */
+    type: string;
+    size: number;
+    /** Where to open or download it. */
+    url?: string | null;
+}
+export interface Reaction {
+    emoji: string;
+    count: number;
+    /** Whether the person using the chatter is among those who reacted. */
+    mine: boolean;
+}
+/** A field's change, as a record's history keeps it. */
+export interface TrackedChange {
+    field: string;
+    label: string;
+    from: string | null;
+    to: string | null;
+}
+export interface ChatterMessage {
+    id: ChatterId;
+    /** A message the record's followers get, a note for the team only, or an event such as a tracked change. */
+    kind: 'message' | 'note' | 'event';
+    author: Person | null;
+    /** When it was posted, as an ISO date and time. */
+    date: string;
+    /** HTML. The chatter cleans it before it shows it. */
+    body: string;
+    tracking?: TrackedChange[];
+    attachments?: Attachment[];
+    reactions?: Reaction[];
+    /** The message this one answers. */
+    parentId?: ChatterId | null;
+    /** The people it @mentions. */
+    mentions?: Person[];
+}
+export interface NewMessage {
+    kind: 'message' | 'note';
+    /** HTML made from what was typed, every character escaped. */
+    body: string;
+    attachments?: Attachment[];
+    parentId?: ChatterId | null;
+    /** The people @mentioned. */
+    mentions?: Person[];
+}
+export interface ActivityType {
+    id: ChatterId;
+    name: string;
+    /** An icon by name, one of Fieldia's own or the app's. */
+    icon?: string;
+    /** Days from today an activity of this type is due, unless a date is chosen. */
+    daysUntilDue?: number;
+}
+export interface Activity {
+    id: ChatterId;
+    type: ActivityType;
+    summary?: string | null;
+    note?: string | null;
+    /** The day it is due: `YYYY-MM-DD`. */
+    due: string;
+    assignee: Person;
+}
+export interface NewActivity {
+    typeId: ChatterId;
+    summary?: string;
+    note?: string;
+    due: string;
+    assigneeId: ChatterId;
+}
+export interface Follower {
+    id: ChatterId;
+    person: Person;
+}
+export interface ChatterSource {
+    /** The record's messages, notes and events, newest first. */
+    messages(record: RecordRef): Promise<ChatterMessage[]>;
+    post(record: RecordRef, message: NewMessage): Promise<ChatterMessage>;
+    /** Store a file, to send with a message. */
+    upload?(record: RecordRef, file: File): Promise<Attachment>;
+    /** Add the person's reaction, or take it away when it is there already. Returns the message's reactions. */
+    react?(record: RecordRef, messageId: ChatterId, emoji: string): Promise<Reaction[]>;
+    /** People to @mention, to give an activity to, or to add as followers. */
+    people?(query: string): Promise<Person[]>;
+    activityTypes?(): Promise<ActivityType[]>;
+    activities?(record: RecordRef): Promise<Activity[]>;
+    schedule?(record: RecordRef, activity: NewActivity): Promise<Activity>;
+    /** Done, with what came of it: the backend usually posts it as a message. */
+    markDone?(record: RecordRef, activityId: ChatterId, feedback?: string): Promise<void>;
+    cancel?(record: RecordRef, activityId: ChatterId): Promise<void>;
+    followers?(record: RecordRef): Promise<Follower[]>;
+    follow?(record: RecordRef, personId: ChatterId): Promise<Follower>;
+    unfollow?(record: RecordRef, followerId: ChatterId): Promise<void>;
+}