@graview/primitives 0.1.64 → 0.1.66

package/dist/told-card.js

@@ -0,0 +1,197 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { heldAlso, seenOnThisPage, toldHeld } from "./told-listed.js";
+export { seenOnThisPage, toldListed } from "./told-listed.js";
+import { recordsOfTarget } from "@graview/core/catalog";
+import { similarTellings, tellingExamples, tellingOf, toldSeenBy } from "@graview/core/told";
+import { useEffect, useId, useState } from "react";
+/**
+ * WHAT A PERSON TELLS GRAVIEW, KEPT FROM THE ANSWER CARD (Roadmap
+ * f-menu-learns), fetched with the card.
+ *
+ * Each Enter or reply on the card is one telling (`@graview/core/told`):
+ * the words, what they were on (a kind and ids), the records they were read
+ * as, the people they named, what was decided and by which slot, the time
+ * it took, and — as the person goes on — how it ended and what they thought
+ * of it. It goes to the host's door (`HostAi.told`); with none, nothing is
+ * kept and the card draws no rating, because a press that keeps nothing
+ * would say something untrue.
+ */
+/** The kind the words are on: the record's, the list's, the selection's first. */
+export function kindOfTarget(store, target) {
+    if (target.on === "list")
+        return target.kind;
+    if (target.on === "lens")
+        return target.kind;
+    const first = recordsOfTarget(target)[0];
+    return first ? store.graph.getNode(first)?.kind : undefined;
+}
+/**
+ * THE LIKE 👍 TELLINGS, AS EXAMPLES FOR THE SLOTS: the top three like the
+ * words on this kind that were rated 👍 and are not excluded — given to Jev
+ * and the light model by name, and their ids kept on the telling they
+ * informed.
+ */
+export function examplesHere(told, store, principal, words, target) {
+    // Never in the way of an answer: only what is already at hand, read when the card opened.
+    const held = told ? toldHeld(told) : undefined;
+    if (!held)
+        return { examples: [], ids: [] };
+    const kind = kindOfTarget(store, target);
+    const like = similarTellings(toldSeenBy(held, seenOnThisPage(store, principal)), { words, ...(kind ? { kind } : {}) }, { reader: principal, rated: true, most: 3 });
+    return { examples: tellingExamples(like), ids: like.map((one) => one.telling.id) };
+}
+/** Which slot decided it, from the stages the entry timed. */
+function slotOf(entry) {
+    const stages = new Set((entry.stages ?? []).map((one) => one.stage));
+    if (stages.has("thinking"))
+        return "full";
+    if (stages.has("light"))
+        return "light";
+    if (stages.has("fast"))
+        return "graph";
+    return (entry.usage ?? []).some((usage) => usage.tier === "thinking") ? "full" : undefined;
+}
+/** What was decided: an act over N records, a plan, an open answer, or nothing it could do. */
+function decidedOf(result, plan) {
+    if (result.interaction.outcome === "failed" || (plan && "refused" in plan))
+        return { type: "refusal" };
+    if (plan && "question" in plan)
+        return plan.proposal ? { type: "plan", edits: plan.parts.length } : { type: "refusal" };
+    const proposals = result.ghost?.proposals ?? [];
+    if (proposals.length > 0) {
+        const act = proposals[0].call.name;
+        return { type: "act", act, records: new Set(proposals.map((one) => one.record ?? one.id)).size };
+    }
+    return { type: "answer" };
+}
+/** The records the words named as people: a proposal's values that are records, other than what it acts on. */
+function peopleOf(store, result) {
+    const people = new Set();
+    for (const proposal of result.ghost?.proposals ?? []) {
+        for (const value of Object.values(proposal.call.args)) {
+            if (typeof value === "string" && value !== proposal.record && store.graph.getNode(value))
+                people.add(value);
+        }
+    }
+    return [...people];
+}
+/** The draft of one telling: the words, what they were on, what was decided and how long it took. */
+export function tellingDraftOf(store, asked) {
+    const { target, result } = asked;
+    const kind = kindOfTarget(store, target);
+    const id = target.on === "record" || target.on === "field" ? target.id : undefined;
+    const place = target.on === "lens" || target.on === "place" ? target.place : undefined;
+    const reading = result.reading ? { which: result.reading.which, kind: result.reading.kind, records: result.reading.records } : undefined;
+    const people = peopleOf(store, result);
+    const slot = slotOf(result.interaction);
+    const decided = decidedOf(result, asked.plan);
+    return {
+        words: asked.words,
+        target: { on: target.on, ...(kind ? { kind } : {}), ...(id ? { id } : {}), ...(place ? { place } : {}) },
+        ...(reading ? { reading } : {}),
+        ...(people.length > 0 ? { people } : {}),
+        decided,
+        ...(slot ? { slot } : {}),
+        ...(result.interaction.stages ? { stages: result.interaction.stages } : {}),
+        ms: asked.ms,
+        outcome: "previewed",
+        ...(asked.conversation ? { conversation: asked.conversation } : {}),
+        ...(asked.follows ? { follows: asked.follows } : {}),
+        interaction: result.interaction.id,
+        ...(asked.examples && asked.examples.length > 0 ? { examples: asked.examples } : {}),
+    };
+}
+/** Kept with the host, as the person: the telling, or nothing for a visitor or a door that is not there. */
+export function keepTelling(told, draft, by) {
+    if (!told)
+        return undefined;
+    const telling = tellingOf(draft, by);
+    if (!telling)
+        return undefined;
+    heldAlso(told, telling);
+    void Promise.resolve()
+        .then(() => told.add(telling))
+        .catch(() => undefined);
+    return telling;
+}
+/** A change to a kept telling, handed to the host and never awaited. */
+export function changeTelling(told, id, change) {
+    if (!told)
+        return;
+    void Promise.resolve()
+        .then(() => told.change(id, change))
+        .catch(() => undefined);
+}
+/** How an interaction's entry ended, as a telling says it. */
+const OUTCOME_OF = { accepted: "accepted", partly: "accepted", drawn: "accepted", dismissed: "declined" };
+/**
+ * HOW IT ENDED, HEARD FROM THE DESK: the change it proposed accepted (on the
+ * card or on the tray once the card is put away), dismissed, or undone — an
+ * undo a quiet sign, never a 👎. Heard until it is undone, or for half an
+ * hour.
+ */
+export function watchTelling(desk, told, telling) {
+    let said;
+    const hear = () => {
+        const entry = desk.get().entries.find((one) => one.id === telling.interaction);
+        if (!entry)
+            return;
+        const outcome = entry.undone ? "undone" : OUTCOME_OF[entry.outcome];
+        if (!outcome || outcome === said)
+            return;
+        said = outcome;
+        changeTelling(told, telling.id, { outcome });
+        if (outcome === "undone")
+            stop();
+    };
+    const unsubscribe = desk.subscribe(hear);
+    const timer = setTimeout(() => stop(), 30 * 60_000);
+    const stop = () => {
+        unsubscribe();
+        clearTimeout(timer);
+    };
+    return stop;
+}
+/**
+ * 👍 AND 👎 AT THE FOOT OF AN ANSWERED CARD: quiet, reachable from the
+ * keyboard, named "This was right" and "This was wrong"; a rating changed
+ * while the card is open; a 👎 offers one optional line, "What should it
+ * have done?", kept with the telling.
+ */
+export function RateTelling({ told, telling }) {
+    const [rating, setRating] = useState(telling.rating);
+    const [should, setShould] = useState("");
+    const [kept, setKept] = useState(false);
+    const field = useId();
+    useEffect(() => {
+        setRating(telling.rating);
+        setShould("");
+        setKept(false);
+    }, [telling.id, telling.rating]);
+    const rate = (next) => {
+        const now = rating === next ? undefined : next;
+        setRating(now);
+        setKept(false);
+        changeTelling(told, telling.id, { rating: now ?? null });
+    };
+    const keepShould = () => {
+        const words = should.trim();
+        if (!words || rating !== "down")
+            return;
+        changeTelling(told, telling.id, { should: words });
+        setKept(true);
+    };
+    return (_jsxs("div", { "data-testid": "quick-ask-rating", "data-rating": rating ?? "", style: { display: "grid", gap: 6 }, children: [_jsxs("div", { role: "group", "aria-label": "Was this right?", style: { display: "flex", gap: 4, justifyContent: "flex-end" }, children: [_jsx("button", { type: "button", "data-testid": "quick-ask-right", "aria-label": "This was right", title: "This was right", "aria-pressed": rating === "up", onClick: () => rate("up"), style: rating === "up" ? THUMB_ON : THUMB, children: _jsx("span", { "aria-hidden": "true", children: "\uD83D\uDC4D" }) }), _jsx("button", { type: "button", "data-testid": "quick-ask-wrong", "aria-label": "This was wrong", title: "This was wrong", "aria-pressed": rating === "down", onClick: () => rate("down"), style: rating === "down" ? THUMB_ON : THUMB, children: _jsx("span", { "aria-hidden": "true", children: "\uD83D\uDC4E" }) })] }), rating === "down" ? (_jsxs("div", { style: { display: "grid", gap: 2 }, children: [_jsxs("label", { htmlFor: field, style: { fontSize: "0.75rem", color: "var(--graview-ink-muted)" }, children: ["What should it have done? ", _jsx("span", { style: { color: "var(--graview-ink-faint)" }, children: "(optional)" })] }), _jsx("input", { id: field, type: "text", "data-testid": "quick-ask-should", value: should, maxLength: 300, autoComplete: "off", enterKeyHint: "done", onChange: (event) => {
+                            setShould(event.target.value);
+                            setKept(false);
+                        }, onKeyDown: (event) => {
+                            if (event.key !== "Enter")
+                                return;
+                            event.preventDefault();
+                            keepShould();
+                        }, onBlur: keepShould, style: SHOULD }), kept ? (_jsx("span", { role: "status", "data-testid": "quick-ask-should-kept", style: { fontSize: "0.75rem", color: "var(--graview-ink-muted)" }, children: "Kept, to learn from." })) : null] })) : null] }));
+}
+const THUMB = { display: "inline-grid", placeItems: "center", width: 30, height: 28, padding: 0, font: "inherit", fontSize: "0.875rem", lineHeight: 1, background: "transparent", border: "1px solid transparent", borderRadius: 6, boxShadow: "none", cursor: "pointer", opacity: 0.7 };
+const THUMB_ON = { ...THUMB, opacity: 1, borderColor: "var(--graview-accent)", background: "var(--graview-panel)" };
+const SHOULD = { boxSizing: "border-box", width: "100%", height: 32, padding: "0 8px", font: "inherit", fontSize: "max(1rem,16px)", color: "var(--graview-ink)", background: "var(--graview-panel)", border: "1px solid var(--graview-edge)", borderRadius: 8 };
+//# sourceMappingURL=told-card.js.map

package/dist/told-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-card.js","sourceRoot":"","sources":["../src/told-card.tsx"],"names":[],"mappings":"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"}

package/dist/told-listed.d.ts

@@ -0,0 +1,14 @@
+import { type AnySchema, type Principal, type Store } from "@graview/core";
+import type { Telling, ToldStore } from "@graview/core/told";
+/** The host's tellings, as this page last read them; a telling this page kept is in it at once. */
+export declare function toldListed(told: ToldStore): Promise<readonly Telling[]>;
+/** What is already at hand, without waiting: the last list read, or nothing yet. */
+export declare const toldHeld: (told: ToldStore) => readonly Telling[] | undefined;
+export declare function heldAlso(told: ToldStore, telling: Telling): void;
+/**
+ * WHAT A READER SEES ON THIS PAGE: a record the page holds and the sight
+ * lets them see. A page's store is the seat's view, so a record kept from
+ * them is not in it at all — and one that is not there is not seen.
+ */
+export declare function seenOnThisPage(store: Store<AnySchema>, principal: Principal): (id: string) => boolean;
+//# sourceMappingURL=told-listed.d.ts.map

package/dist/told-listed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-listed.d.ts","sourceRoot":"","sources":["../src/told-listed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW7D,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAYvE;AAED,oFAAoF;AACpF,eAAO,MAAM,QAAQ,GAAI,MAAM,SAAS,KAAG,SAAS,OAAO,EAAE,GAAG,SAAoC,CAAC;AAErG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAMhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAGrG"}

package/dist/told-listed.js

@@ -0,0 +1,46 @@
+import { seesId } from "@graview/core";
+/*
+ * WHAT A PAGE HAS READ OF ITS HOST'S TELLINGS (Roadmap f-menu-learns), one
+ * copy for the menu's suggestions and the answer card's examples alike, and
+ * what a reader sees on this page. No React, no part of what a page draws.
+ */
+/** What a page has read of its host's tellings, for a few seconds, so typing does not ask again on every key. */
+const LISTED = new WeakMap();
+const FRESH_MS = 5000;
+/** The host's tellings, as this page last read them; a telling this page kept is in it at once. */
+export function toldListed(told) {
+    const held = LISTED.get(told);
+    if (held && Date.now() - held.at < FRESH_MS)
+        return held.list;
+    const entry = { at: Date.now(), list: Promise.resolve([]) };
+    entry.list = Promise.resolve()
+        .then(() => told.list())
+        .catch(() => [])
+        .then((list) => (entry.value = [...list, ...(entry.value ?? []).filter((one) => !list.some((had) => had.id === one.id))]));
+    // What was read last stays at hand while it is read again.
+    if (held?.value)
+        entry.value = held.value;
+    LISTED.set(told, entry);
+    return entry.list;
+}
+/** What is already at hand, without waiting: the last list read, or nothing yet. */
+export const toldHeld = (told) => LISTED.get(told)?.value;
+export function heldAlso(told, telling) {
+    const held = LISTED.get(told);
+    if (!held)
+        return;
+    const add = (list) => [...list.filter((one) => one.id !== telling.id), telling];
+    if (held.value)
+        held.value = add(held.value);
+    LISTED.set(told, { at: held.at, list: held.list.then(add), ...(held.value ? { value: held.value } : {}) });
+}
+/**
+ * WHAT A READER SEES ON THIS PAGE: a record the page holds and the sight
+ * lets them see. A page's store is the seat's view, so a record kept from
+ * them is not in it at all — and one that is not there is not seen.
+ */
+export function seenOnThisPage(store, principal) {
+    const sees = seesId(store, principal);
+    return (id) => store.graph.getNode(id) !== undefined && sees(id);
+}
+//# sourceMappingURL=told-listed.js.map

package/dist/told-listed.js.map

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

package/dist/told-panel-door.d.ts

@@ -0,0 +1,17 @@
+import type { AnySchema, Principal, Store } from "@graview/core";
+import type { ToldStore } from "@graview/core/told";
+import type { ComponentType } from "react";
+/**
+ * "WHAT GRAVIEW HAS BEEN TOLD" (Roadmap f-menu-learns), the door: the
+ * Studio's panel of what people told this app (`told-panel.tsx`) is fetched
+ * when it is opened, never with the Studio — a host that hands the Studio
+ * in carries only this.
+ */
+export interface ToldPanelProps {
+    readonly told: ToldStore;
+    readonly store: Store<AnySchema>;
+    readonly principal: Principal;
+    readonly onClose: () => void;
+}
+export declare const ToldPanelDoor: ComponentType<ToldPanelProps>;
+//# sourceMappingURL=told-panel-door.d.ts.map

package/dist/told-panel-door.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-panel-door.d.ts","sourceRoot":"","sources":["../src/told-panel-door.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAID,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,cAAc,CAGvD,CAAC"}

package/dist/told-panel-door.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { retryingImport } from "@graview/core/retry";
+import { lazyModule } from "@graview/react/provider";
+const panel = /* @__PURE__ */ lazyModule(retryingImport(() => import("./told-ui.js")));
+export const ToldPanelDoor = /* @__PURE__ */ panel.part((module, props) => _jsx(module.ToldPanel, { ...props }), { what: "What Graview has been told" });
+//# sourceMappingURL=told-panel-door.js.map

package/dist/told-panel-door.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-panel-door.js","sourceRoot":"","sources":["../src/told-panel-door.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgBrD,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,aAAa,GAAkC,eAAe,CAAC,KAAK,CAAC,IAAI,CACpF,CAAC,MAAM,EAAE,KAAqB,EAAE,EAAE,CAAC,KAAC,MAAM,CAAC,SAAS,OAAK,KAAK,GAAI,EAClE,EAAE,IAAI,EAAE,4BAA4B,EAAE,CACvC,CAAC"}

package/dist/told-panel.d.ts

@@ -0,0 +1,19 @@
+import { type AnySchema, type Principal, type Store } from "@graview/core";
+import { type ToldStore } from "@graview/core/told";
+/**
+ * WHAT GRAVIEW HAS BEEN TOLD, IN THE STUDIO (Roadmap f-menu-learns): every
+ * telling this app's host keeps (`HostAi.told`, `@graview/core/told`) that
+ * the owner may see — a telling about a record hidden from them is not
+ * listed — with its words, what it did, how it ended, its rating, who told
+ * it, when, and how long it took; filtered by rating, outcome and kind.
+ * From one an owner marks a good example, excludes it from suggestions, or
+ * deletes it; the line at the top says what is teaching the system. Only
+ * in the Studio, which only the app's owners and editors are offered.
+ */
+export declare function ToldPanel({ told, store, principal, onClose }: {
+    readonly told: ToldStore;
+    readonly store: Store<AnySchema>;
+    readonly principal: Principal;
+    readonly onClose: () => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=told-panel.d.ts.map

package/dist/told-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-panel.d.ts","sourceRoot":"","sources":["../src/told-panel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AACxG,OAAO,EAYL,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,+BAkIzL"}

package/dist/told-panel.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { layer, nameOfAuthor, seesId } from "@graview/core";
+import { TELLING_OUTCOMES, TELLING_OUTCOME_WORDS, tellingDidWords, toldAfter, toldMatching, toldSeenBy, toldTeachingWords, } from "@graview/core/told";
+import { useEffect, useMemo, useRef, useState } from "react";
+/**
+ * WHAT GRAVIEW HAS BEEN TOLD, IN THE STUDIO (Roadmap f-menu-learns): every
+ * telling this app's host keeps (`HostAi.told`, `@graview/core/told`) that
+ * the owner may see — a telling about a record hidden from them is not
+ * listed — with its words, what it did, how it ended, its rating, who told
+ * it, when, and how long it took; filtered by rating, outcome and kind.
+ * From one an owner marks a good example, excludes it from suggestions, or
+ * deletes it; the line at the top says what is teaching the system. Only
+ * in the Studio, which only the app's owners and editors are offered.
+ */
+export function ToldPanel({ told, store, principal, onClose }) {
+    const [tellings, setTellings] = useState(null);
+    const [filter, setFilter] = useState({});
+    const panel = useRef(null);
+    useEffect(() => {
+        let live = true;
+        void Promise.resolve()
+            .then(() => told.list())
+            .then((list) => live && setTellings(list), () => live && setTellings([]));
+        panel.current?.focus({ preventScroll: true });
+        return () => {
+            live = false;
+        };
+    }, [told]);
+    const seen = useMemo(() => (tellings ? toldSeenBy(tellings, seesId(store, principal)) : []), [tellings, store, principal]);
+    const shown = useMemo(() => [...toldMatching(seen, filter)].sort((a, b) => (a.at < b.at ? 1 : -1)), [seen, filter]);
+    const kinds = useMemo(() => [...new Set(seen.flatMap((one) => one.reading?.kind ?? one.target.kind ?? []))].sort(), [seen]);
+    const titleOf = (act) => store.allMutations().find((one) => one.name === act)?.title ?? act;
+    const plural = (kind) => store.schema.tryDefinition(kind)?.plural ?? kind;
+    const who = (telling) => {
+        try {
+            return nameOfAuthor(telling.by, { graph: store.graph, schema: store.schema });
+        }
+        catch {
+            return telling.by.id ?? telling.by.kind;
+        }
+    };
+    const change = (id, with_) => {
+        setTellings((list) => (list ? toldAfter(list, { change: id, with: with_ }) : list));
+        void Promise.resolve()
+            .then(() => told.change(id, with_))
+            .catch(() => undefined);
+    };
+    const remove = (id) => {
+        setTellings((list) => (list ? toldAfter(list, { remove: id }) : list));
+        void Promise.resolve()
+            .then(() => told.remove(id))
+            .catch(() => undefined);
+    };
+    return (_jsxs("section", { ref: panel, tabIndex: -1, "data-testid": "told-panel", "data-graview-overlay": "", "aria-label": "What Graview has been told", onKeyDown: (event) => {
+            if (event.key !== "Escape")
+                return;
+            event.stopPropagation();
+            onClose();
+        }, style: PANEL, children: [_jsxs("div", { style: { display: "flex", alignItems: "baseline", gap: 8 }, children: [_jsx("h2", { style: { margin: 0, fontSize: "1rem", fontWeight: 600, flex: "1 1 auto" }, children: "What Graview has been told" }), _jsx("button", { type: "button", "data-testid": "told-close", onClick: onClose, style: BUTTON, children: "Close" })] }), _jsx("p", { "data-testid": "told-teaching", style: { margin: 0, fontSize: "0.875rem", color: "var(--graview-ink-muted)" }, children: tellings === null ? "Reading what was told…" : toldTeachingWords(seen) }), _jsxs("div", { role: "group", "aria-label": "Show only", style: { display: "flex", flexWrap: "wrap", gap: 8, fontSize: "0.8125rem" }, children: [_jsxs("label", { style: FILTER, children: ["Rating", _jsxs("select", { "data-testid": "told-filter-rating", value: filter.rating ?? "", onChange: (event) => setFilter(({ rating: _drop, ...rest }) => (event.target.value ? { ...rest, rating: event.target.value } : rest)), children: [_jsx("option", { value: "", children: "Any" }), _jsx("option", { value: "up", children: "\uD83D\uDC4D Right" }), _jsx("option", { value: "down", children: "\uD83D\uDC4E Wrong" }), _jsx("option", { value: "none", children: "Not rated" })] })] }), _jsxs("label", { style: FILTER, children: ["Outcome", _jsxs("select", { "data-testid": "told-filter-outcome", value: filter.outcome ?? "", onChange: (event) => setFilter(({ outcome: _drop, ...rest }) => (event.target.value ? { ...rest, outcome: event.target.value } : rest)), children: [_jsx("option", { value: "", children: "Any" }), TELLING_OUTCOMES.map((outcome) => (_jsx("option", { value: outcome, children: TELLING_OUTCOME_WORDS[outcome] }, outcome)))] })] }), _jsxs("label", { style: FILTER, children: ["Kind", _jsxs("select", { "data-testid": "told-filter-kind", value: filter.kind ?? "", onChange: (event) => setFilter(({ kind: _drop, ...rest }) => (event.target.value ? { ...rest, kind: event.target.value } : rest)), children: [_jsx("option", { value: "", children: "Any" }), kinds.map((kind) => (_jsx("option", { value: kind, children: plural(kind) }, kind)))] })] })] }), tellings !== null && shown.length === 0 ? (_jsx("p", { "data-testid": "told-none", style: { margin: 0, fontSize: "0.875rem", color: "var(--graview-ink-muted)" }, children: seen.length === 0 ? "Nothing has been told here yet." : "Nothing told here fits these." })) : null, _jsx("ol", { style: { margin: 0, padding: 0, listStyle: "none", display: "grid", gap: 8, overflowY: "auto" }, children: shown.map((telling) => (_jsxs("li", { "data-testid": "told-entry", "data-telling": telling.id, "data-outcome": telling.outcome, "data-rating": telling.rating ?? "", "data-excluded": telling.excluded ? "" : undefined, "data-pinned": telling.pinned ? "" : undefined, style: ENTRY, children: [_jsxs("p", { style: { margin: 0, fontWeight: 550, overflowWrap: "anywhere" }, children: ["\u201C", telling.words, "\u201D"] }), _jsxs("p", { style: { margin: 0, fontSize: "0.8125rem" }, children: [tellingDidWords(telling, titleOf), " \u00B7 ", TELLING_OUTCOME_WORDS[telling.outcome], telling.rating ? ` · ${telling.rating === "up" ? "👍 right" : "👎 wrong"}` : "", telling.pinned ? " · a good example" : "", telling.excluded ? " · excluded from suggestions" : ""] }), telling.should ? _jsxs("p", { style: { margin: 0, fontSize: "0.8125rem", fontStyle: "italic" }, children: ["Should have: ", telling.should] }) : null, _jsxs("p", { style: { margin: 0, fontSize: "0.75rem", color: "var(--graview-ink-muted)" }, children: [who(telling), " \u00B7 ", _jsx("time", { dateTime: telling.at, children: new Date(telling.at).toLocaleString() }), telling.ms !== undefined ? ` · ${telling.ms < 1000 ? `${telling.ms} ms` : `${(telling.ms / 1000).toFixed(1)} s`}` : ""] }), _jsxs("div", { style: { display: "flex", flexWrap: "wrap", gap: 6 }, children: [_jsx("button", { type: "button", "data-testid": "told-pin", "aria-pressed": telling.pinned === true, onClick: () => change(telling.id, { pinned: !telling.pinned }), style: BUTTON, children: telling.pinned ? "Not a good example" : "A good example" }), _jsx("button", { type: "button", "data-testid": "told-exclude", "aria-pressed": telling.excluded === true, onClick: () => change(telling.id, { excluded: !telling.excluded }), style: BUTTON, children: telling.excluded ? "Suggest it again" : "Exclude from suggestions" }), _jsx("button", { type: "button", "data-testid": "told-delete", onClick: () => remove(telling.id), style: BUTTON, children: "Delete" })] })] }, telling.id))) })] }));
+}
+const PANEL = {
+    position: "absolute",
+    insetBlock: "60px 12px",
+    insetInlineEnd: 12,
+    width: "min(440px, calc(100% - 24px))",
+    boxSizing: "border-box",
+    display: "flex",
+    flexDirection: "column",
+    gap: 10,
+    padding: 14,
+    borderRadius: 12,
+    border: "1px solid var(--graview-edge)",
+    background: "var(--graview-float)",
+    color: "var(--graview-ink)",
+    boxShadow: "var(--graview-lift-high)",
+    // Over the studio's own picture, under nothing else the dialog holds.
+    zIndex: layer("popover"),
+    overflow: "hidden",
+};
+const ENTRY = { display: "grid", gap: 4, padding: 10, borderRadius: 10, border: "1px solid var(--graview-edge)", background: "var(--graview-panel)" };
+const BUTTON = { padding: "2px 10px", minHeight: 28, font: "inherit", fontSize: "0.8125rem", borderRadius: 8 };
+const FILTER = { display: "inline-flex", alignItems: "center", gap: 4 };
+//# sourceMappingURL=told-panel.js.map

package/dist/told-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-panel.js","sourceRoot":"","sources":["../src/told-panel.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAA8C,MAAM,eAAe,CAAC;AACxG,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,UAAU,EACV,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAsB,MAAM,OAAO,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAA+H;IACxL,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA4B,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAa,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,OAAO,CAAC,OAAO,EAAE;aACnB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAc,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACpI,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACpH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5H,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;IACpG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAE,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAqC,EAAE,MAAM,IAAI,IAAI,CAAC;IACvH,MAAM,GAAG,GAAG,CAAC,OAAgB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAc,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,KAAoB,EAAE,EAAE;QAClD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,KAAK,OAAO,CAAC,OAAO,EAAE;aACnB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE;QAC5B,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,KAAK,OAAO,CAAC,OAAO,EAAE;aACnB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;aAC3B,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,OAAO,CACL,mBACE,GAAG,EAAE,KAAK,EACV,QAAQ,EAAE,CAAC,CAAC,iBACA,YAAY,0BACH,EAAE,gBACZ,4BAA4B,EACvC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACnB,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;gBAAE,OAAO;YACnC,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC,EACD,KAAK,EAAE,KAAK,aAEZ,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,aAC7D,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,2CAAiC,EAC9G,iBAAQ,IAAI,EAAC,QAAQ,iBAAa,YAAY,EAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAErE,IACL,EACN,2BAAe,eAAe,EAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,0BAA0B,EAAE,YACzG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,GACrE,EACJ,eAAK,IAAI,EAAC,OAAO,gBAAY,WAAW,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,aAClH,iBAAO,KAAK,EAAE,MAAM,uBAElB,iCAAoB,oBAAoB,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAChO,iBAAQ,KAAK,EAAC,EAAE,oBAAa,EAC7B,iBAAQ,KAAK,EAAC,IAAI,mCAAkB,EACpC,iBAAQ,KAAK,EAAC,MAAM,mCAAkB,EACtC,iBAAQ,KAAK,EAAC,MAAM,0BAAmB,IAChC,IACH,EACR,iBAAO,KAAK,EAAE,MAAM,wBAElB,iCAAoB,qBAAqB,EAAC,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAuB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAC9N,iBAAQ,KAAK,EAAC,EAAE,oBAAa,EAC5B,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACjC,iBAAsB,KAAK,EAAE,OAAO,YACjC,qBAAqB,CAAC,OAAO,CAAC,IADpB,OAAO,CAEX,CACV,CAAC,IACK,IACH,EACR,iBAAO,KAAK,EAAE,MAAM,qBAElB,iCAAoB,kBAAkB,EAAC,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAChM,iBAAQ,KAAK,EAAC,EAAE,oBAAa,EAC5B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,iBAAmB,KAAK,EAAE,IAAI,YAC3B,MAAM,CAAC,IAAI,CAAC,IADF,IAAI,CAER,CACV,CAAC,IACK,IACH,IACJ,EACL,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACzC,2BAAe,WAAW,EAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,0BAA0B,EAAE,YACrG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,+BAA+B,GACtF,CACL,CAAC,CAAC,CAAC,IAAI,EACR,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,YAChG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACtB,6BAAiC,YAAY,kBAAe,OAAO,CAAC,EAAE,kBAAgB,OAAO,CAAC,OAAO,iBAAe,OAAO,CAAC,MAAM,IAAI,EAAE,mBAAiB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,iBAAe,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,aACpP,aAAG,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,uBAAI,OAAO,CAAC,KAAK,cAAM,EACzF,aAAG,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,aAC3C,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,cAAK,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAC5E,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAC/E,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACzC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,IACrD,EACH,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,aAAG,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,8BAAgB,OAAO,CAAC,MAAM,IAAK,CAAC,CAAC,CAAC,IAAI,EAC/H,aAAG,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,0BAA0B,EAAE,aAC5E,GAAG,CAAC,OAAO,CAAC,cAAI,eAAM,QAAQ,EAAE,OAAO,CAAC,EAAE,YAAG,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE,GAAQ,EAC1F,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IACrH,EACJ,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,aACvD,iBAAQ,IAAI,EAAC,QAAQ,iBAAa,UAAU,kBAAe,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,YAC9J,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,gBAAgB,GAClD,EACT,iBAAQ,IAAI,EAAC,QAAQ,iBAAa,cAAc,kBAAe,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,YACxK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,0BAA0B,GAC5D,EACT,iBAAQ,IAAI,EAAC,QAAQ,iBAAa,aAAa,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,uBAEvF,IACL,KAvBC,OAAO,CAAC,EAAE,CAwBd,CACN,CAAC,GACC,IACG,CACX,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAkB;IAC3B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,WAAW;IACvB,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE,+BAA+B;IACtC,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,EAAE;IACP,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,MAAM,EAAE,+BAA+B;IACvC,UAAU,EAAE,sBAAsB;IAClC,KAAK,EAAE,oBAAoB;IAC3B,SAAS,EAAE,0BAA0B;IACrC,sEAAsE;IACtE,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,EAAE,QAAQ;CACnB,CAAC;AACF,MAAM,KAAK,GAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;AACrK,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AAC9H,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC"}

package/dist/told-ui.d.ts

@@ -0,0 +1,5 @@
+import "./frame.js";
+export { changeTelling, examplesHere, keepTelling, RateTelling, seenOnThisPage, tellingDraftOf, toldListed, watchTelling } from "./told-card.js";
+export { readToldHere, toldForHere, toldSuggestionsFrom } from "./menu-told.js";
+export { ToldPanel } from "./told-panel.js";
+//# sourceMappingURL=told-ui.d.ts.map

package/dist/told-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-ui.d.ts","sourceRoot":"","sources":["../src/told-ui.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AAQpB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjJ,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/told-ui.js

@@ -0,0 +1,12 @@
+import "./frame.js"; // A door: tied to what the page drew first (TIED DOORS, packages/primitives/src/frame.ts).
+/*
+ * WHAT PEOPLE TELL GRAVIEW, ONE CHUNK (Roadmap f-menu-learns): the card's
+ * telling and its thumbs, the menu's suggestions and the Studio's panel,
+ * with `@graview/core/told`, fetched together by whichever door asks first
+ * (`quick-ask.tsx`, `menu-told-door.ts`, `told-panel-door.tsx`) — one
+ * request, and no piece of it on a page that never tells Graview anything.
+ */
+export { changeTelling, examplesHere, keepTelling, RateTelling, seenOnThisPage, tellingDraftOf, toldListed, watchTelling } from "./told-card.js";
+export { readToldHere, toldForHere, toldSuggestionsFrom } from "./menu-told.js";
+export { ToldPanel } from "./told-panel.js";
+//# sourceMappingURL=told-ui.js.map

package/dist/told-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"told-ui.js","sourceRoot":"","sources":["../src/told-ui.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC,CAAC,2FAA2F;AAChH;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjJ,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/when-words.d.ts

@@ -0,0 +1,21 @@
+/** How far a day is from today, as a person says it: "today", "tomorrow", "in 3 days", "2 weeks ago", "9 years ago". */
+export declare function fromToday(day: string, today: string): string;
+/**
+ * A stored day or moment said with its weekday and how far it is from
+ * today: "Fri, Sep 4 · in 3 days", "Mon, Sep 25, 2017, 11:30 AM · 9 years
+ * ago" — its year only when it is not this one. Undefined for anything that
+ * names no whole day (a month alone, a year alone, words).
+ */
+export declare function whenSaid(stored: string, today: string, options?: {
+    readonly locale?: string;
+    readonly timeZone?: string;
+}): {
+    readonly words: string;
+    readonly day: string;
+    readonly past: boolean;
+} | undefined;
+/** The day a store judges "late" against: its own (`?today=`, a pinned demo), else today on the app's clock. */
+export declare function todayOf(store: {
+    today?(): string | undefined;
+}): string;
+//# sourceMappingURL=when-words.d.ts.map

package/dist/when-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"when-words.d.ts","sourceRoot":"","sources":["../src/when-words.ts"],"names":[],"mappings":"AAWA,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAMpN;AAED,gHAAgH;AAChH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,IAAI,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAEvE"}

package/dist/when-words.js

@@ -0,0 +1,43 @@
+import { dayOfMoment, isoToday, timeAsRead, weekdayAsRead, zoneFor } from "@graview/core";
+/*
+ * A DAY SAID BOTH WAYS (Roadmap f-facts-by-type): what it is and how far it
+ * is — "Fri, Sep 4 · in 3 days". A record's page said a due date as "Sep 4,
+ * 2026" and left the reader to work out that it was Friday and three days
+ * off; a person deciding what to do next asks the second question first.
+ */
+const DAY_MS = 86_400_000;
+/** How far a day is from today, as a person says it: "today", "tomorrow", "in 3 days", "2 weeks ago", "9 years ago". */
+export function fromToday(day, today) {
+    const days = Math.round((Date.parse(`${day}T00:00:00Z`) - Date.parse(`${today}T00:00:00Z`)) / DAY_MS);
+    if (!Number.isFinite(days))
+        return "";
+    if (days === 0)
+        return "today";
+    if (days === 1)
+        return "tomorrow";
+    if (days === -1)
+        return "yesterday";
+    const far = Math.abs(days);
+    const [count, unit] = far < 14 ? [far, "day"] : far < 60 ? [Math.round(far / 7), "week"] : far < 730 ? [Math.round(far / 30.44), "month"] : [Math.round(far / 365.25), "year"];
+    const said = `${count} ${unit}${count === 1 ? "" : "s"}`;
+    return days > 0 ? `in ${said}` : `${said} ago`;
+}
+/**
+ * A stored day or moment said with its weekday and how far it is from
+ * today: "Fri, Sep 4 · in 3 days", "Mon, Sep 25, 2017, 11:30 AM · 9 years
+ * ago" — its year only when it is not this one. Undefined for anything that
+ * names no whole day (a month alone, a year alone, words).
+ */
+export function whenSaid(stored, today, options = {}) {
+    const day = dayOfMoment(stored, options.timeZone);
+    if (day === undefined)
+        return undefined;
+    const date = weekdayAsRead(day, { weekday: "short", year: day.slice(0, 4) !== today.slice(0, 4) }, options.locale);
+    const time = stored.length > 10 ? `, ${timeAsRead(stored, options.locale, options.timeZone)}` : "";
+    return { words: `${date}${time} · ${fromToday(day, today)}`, day, past: day < today };
+}
+/** The day a store judges "late" against: its own (`?today=`, a pinned demo), else today on the app's clock. */
+export function todayOf(store) {
+    return store.today?.() ?? isoToday(zoneFor());
+}
+//# sourceMappingURL=when-words.js.map

package/dist/when-words.js.map

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