@estiva-app/ui 0.51.0 → 0.53.0

package/dist/ComposerTriggers.d.ts

@@ -0,0 +1,191 @@
+import type { ReactNode } from 'react';
+import { Extension, type Editor } from '@tiptap/core';
+import { type MentionOptions } from '@tiptap/extension-mention';
+import type { SuggestionMenuRow } from './SuggestionMenu';
+import { type SuggestionPopupOptions } from './suggestionPopup';
+/** A person `@` and `!@` offer. */
+export interface MentionPerson {
+    /** The app's own key for the person — the row's key and the chip's `id`. */
+    id: string;
+    name: string;
+    /** The second line of the row: a role, a team. */
+    description?: string;
+    /** Their Nostr key, when they have one — what the body is written with (SPEC §13.1). */
+    pubkey?: string | null;
+    /** The face at the row's start. Default: the package `Avatar` for the name. */
+    avatar?: ReactNode;
+}
+/** How many people the list shows. */
+export declare const PEOPLE_LIMIT = 6;
+/** The people whose name holds the query, the first {@link PEOPLE_LIMIT} of them. */
+export declare function filterPeople(people: readonly MentionPerson[], query: string): MentionPerson[];
+/**
+ * The people list `@` and `!@` open: the face, the name, the second line, and
+ * the Enter hint while highlighted — `MenuItem` at its tall size.
+ */
+export declare function peopleMenu(urgent: boolean): SuggestionPopupOptions<MentionPerson>;
+export interface PersonMentionOptions {
+    /** Everyone the list can offer, asked each time the query changes. */
+    people: () => readonly MentionPerson[];
+}
+type Doc = {
+    descendants: (cb: (node: {
+        type: {
+            name: string;
+        };
+        attrs: Record<string, unknown>;
+    }) => boolean | void) => void;
+};
+/**
+ * `@` — a person, as a chip that writes their key (SPEC §13.1).
+ *
+ *     PersonMention.configure({ people: () => directory })
+ *
+ * Its `pubkey` and `label` are what `mentionText` takes.
+ */
+export declare const PersonMention: import("@tiptap/core").Node<MentionOptions<MentionPerson, MentionPerson> & PersonMentionOptions, any>;
+/**
+ * `!@` — a person, urgently: the same chip in the urgent tone. Its text is an
+ * ordinary mention; the urgency travels as a tag (`urgentTagsFor`), so hand the
+ * write {@link urgentPubkeys}.
+ */
+export declare const UrgentPersonMention: import("@tiptap/core").Node<MentionOptions<MentionPerson, MentionPerson> & PersonMentionOptions, any>;
+/**
+ * The keys the document's urgent mentions name — what the write turns into
+ * `["urgent", <pubkey>]` tags. A chip with no key has no tag to carry; its text
+ * is the old `!@Name`.
+ */
+export declare function urgentPubkeys(editor: {
+    state: {
+        doc: Doc;
+    };
+}): string[] | undefined;
+/** Something `[` offers: a reference drawn as who said it and how it opens. */
+export interface CaptionedItem {
+    /** The referenced thing's id — the row's key and the chip's `id`. */
+    id: string;
+    /** Who, as the list shows them. */
+    label: string;
+    /** The opening words, marks stripped: the caption the row and the chip wear. */
+    snippet: string;
+    /** `nostr:…`, exactly as the body will carry it (`messageReference`). */
+    uri: string;
+    /** What the query is matched against beside `label`. Default: `snippet`. */
+    search?: string;
+    /** The row's second line, e.g. where the thing sits. The chip does not wear it. */
+    description?: string;
+}
+/** One labelled group of `[`'s rows, in the order the list draws them. */
+export interface ReferenceSection {
+    label: string;
+    items: readonly CaptionedItem[];
+}
+/** How many references the list shows. */
+export declare const REFERENCE_LIMIT = 6;
+/**
+ * The references whose label or text holds the query — the last
+ * {@link REFERENCE_LIMIT}, in the order given: a thread is unbounded, and a
+ * list that grew with it would be a hundred rows of prose.
+ */
+export declare function filterReferences(items: readonly CaptionedItem[], query: string): CaptionedItem[];
+export interface CaptionedReferenceOptions {
+    /** Drawn before the caption: a 14px icon. */
+    icon: ReactNode;
+}
+/**
+ * A reference mid-sentence, drawn as `label: snippet` and written as its `uri`
+ * verbatim (SPEC §13.1). The caption is the snapshot it was picked with — a
+ * caption, never parsed. Inserted by {@link ReferenceTrigger}, a paste or a
+ * draft; it opens no list of its own.
+ */
+export declare const CaptionedReference: import("@tiptap/core").Node<MentionOptions<any, import("@tiptap/extension-mention").MentionNodeAttrs> & CaptionedReferenceOptions, any>;
+export interface ReferenceMenuOptions {
+    /** Names the list, e.g. what can be referenced. */
+    ariaLabel: string;
+    /** The section's heading. */
+    sectionLabel: string;
+    /** At each row's start: a 16px icon. */
+    icon: ReactNode;
+}
+/**
+ * The list `[` opens: `label: snippet` rows, the same box as the people list.
+ * One section headed `sectionLabel`, or — when the rows say which section they
+ * are in — a heading for each, in the order the rows arrive.
+ */
+export declare function referenceMenu({ ariaLabel, sectionLabel, icon }: ReferenceMenuOptions): SuggestionPopupOptions<CaptionedItem>;
+export interface ReferenceTriggerOptions extends ReferenceMenuOptions {
+    /** Everything `[` can offer, asked each time the query changes. Narrowed by {@link filterReferences}. */
+    items: () => readonly CaptionedItem[];
+    /**
+     * In place of `items`: the sections to draw for what was typed, already
+     * narrowed and ordered by the app. Empty sections are not drawn.
+     */
+    sections?: (query: string) => readonly ReferenceSection[];
+    /**
+     * Called with a listener while the list is open; the app calls it when what
+     * `sections` would answer has changed — a search landing — and the open list
+     * is drawn again for the same query. Returns the unsubscribe.
+     */
+    subscribe?: (listener: () => void) => () => void;
+    /** The node a pick inserts. Default `captionedReference`. */
+    nodeName: string;
+}
+/**
+ * `[` — reference something, inserted as a {@link CaptionedReference} chip.
+ *
+ * Its own extension rather than the chip's suggestion, so the chip's text (its
+ * `renderText`) does not change with the key that summons the list.
+ */
+export declare const ReferenceTrigger: Extension<ReferenceTriggerOptions, any>;
+/** A row of the `/` list, and what choosing it does. */
+export interface SlashCommand {
+    key: string;
+    row: SuggestionMenuRow;
+    /** Matched beside the row's label: an id, a trigger, a description. */
+    keywords?: readonly string[];
+    /** Runs once the `/query` that summoned the list has been removed. */
+    run: (editor: Editor) => void;
+}
+export interface SlashSection {
+    label: string;
+    commands: readonly SlashCommand[];
+}
+export type FormatId = 'paragraph' | 'heading' | 'subheading' | 'quote' | 'bulletList' | 'orderedList' | 'code';
+export interface FormatDef {
+    id: FormatId;
+    label: string;
+    /** What you type to get it — the input rule the extension registers. Blank when there is none. */
+    trigger?: string;
+}
+/**
+ * The formats `/` offers, in order. The hint is what you would type, not a key
+ * chord. Bold, italic and underline are absent: they act on text already
+ * written, so they are the selection toolbar's.
+ */
+export declare const FORMATS: readonly FormatDef[];
+/** Code as a mark inside the line, or as a block of its own. */
+export type CodeFormat = 'inline' | 'block';
+/**
+ * Apply one format to the current block. `set*` wherever Tiptap has one:
+ * choosing Heading should make a heading, not turn one off. `false` means
+ * nothing changed, not that anything failed.
+ */
+export declare function applyFormat(editor: Editor, id: FormatId, code?: CodeFormat): boolean;
+/** The Format section every app's `/` opens with. */
+export declare function formatSection(code?: CodeFormat): SlashSection;
+/** A row that types another trigger, so its own list opens — `@` from `/`. */
+export declare function typeTrigger(input: string): SlashCommand['run'];
+/** The sections narrowed to a query — the text typed after the `/`. Empty sections stay. */
+export declare function filterSlashSections(sections: readonly SlashSection[], query: string): SlashSection[];
+export interface SlashCommandsOptions {
+    /** The sections, in order: {@link formatSection} first, then the app's own. */
+    sections: readonly SlashSection[];
+}
+/**
+ * `/` — format the line or insert something, at the caret, mid-sentence too.
+ * A `/` inside a word (`and/or`, a path) opens nothing: the plugin wants a
+ * space or the line's start before it.
+ */
+export declare const SlashCommands: Extension<SlashCommandsOptions, any>;
+export {};
+//# sourceMappingURL=ComposerTriggers.d.ts.map

package/dist/ComposerTriggers.d.ts.map

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

package/dist/SuggestionMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SuggestionMenu.d.ts","sourceRoot":"","sources":["../src/SuggestionMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyE,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAA;AACvH,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAA;CAC7C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7C,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5B,wBAAwB;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,iBAAiB,CAAA;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAA;CACnC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,sCA6GvJ"}
+{"version":3,"file":"SuggestionMenu.d.ts","sourceRoot":"","sources":["../src/SuggestionMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiF,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAA;AAC/H,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAA;CAC7C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7C,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5B,wBAAwB;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,iBAAiB,CAAA;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAA;CACnC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,sCAuHvJ"}

package/dist/editor.d.ts

@@ -9,5 +9,6 @@
  */
 export { KeptSelection, SelectionToolbar, normalizeHref, type MarkId, type SelectionToolbarProps } from './SelectionToolbar';
 export { suggestionPopup, isSuggestionActive, isSuggestionOpen, type SuggestionPopupOptions } from './suggestionPopup';
+export { PersonMention, UrgentPersonMention, CaptionedReference, ReferenceTrigger, SlashCommands, peopleMenu, referenceMenu, filterPeople, urgentPubkeys, filterReferences, formatSection, applyFormat, typeTrigger, filterSlashSections, FORMATS, type MentionPerson, type PersonMentionOptions, type CaptionedItem, type CaptionedReferenceOptions, type ReferenceTriggerOptions, type ReferenceMenuOptions, type SlashCommand, type SlashSection, type SlashCommandsOptions, type FormatId, type FormatDef, type CodeFormat, } from './ComposerTriggers';
 export { BlockId, UnknownBlock, ReferenceNode, AttachmentNode, type ReferenceNodeOptions, type ReferenceViewProps, type AttachmentNodeOptions, type AttachmentViewProps, } from './BlockNodes';
 //# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC5H,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AACtH,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC5H,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AACtH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA"}

package/dist/editor.js

@@ -317,7 +317,12 @@ function suggestionPopup(options) {
   return () => {
     let component = null;
     let container = null;
+    let last = null;
+    let unsubscribe;
     const exit = () => {
+      unsubscribe?.();
+      unsubscribe = void 0;
+      last = null;
       if (!component) return;
       openCount = Math.max(0, openCount - 1);
       lastClose = Date.now();
@@ -333,8 +338,20 @@ function suggestionPopup(options) {
         container = document.createElement("div");
         document.body.appendChild(container);
         container.appendChild(component.element);
+        last = props;
+        const { subscribe, refresh } = options;
+        if (subscribe && refresh) {
+          unsubscribe = subscribe(() => {
+            if (!last || !component) return;
+            last = { ...last, items: refresh(last.query) };
+            component.updateProps({ ...last, options });
+          });
+        }
+      },
+      onUpdate: (props) => {
+        last = props;
+        component?.updateProps({ ...props, options });
       },
-      onUpdate: (props) => component?.updateProps({ ...props, options }),
       onKeyDown: ({ event }) => {
         if (event.key === "Escape") {
           exit();
@@ -347,12 +364,308 @@ function suggestionPopup(options) {
   };
 }
 
+// src/ComposerTriggers.tsx
+import { Extension as Extension2 } from "@tiptap/core";
+import { PluginKey as PluginKey2 } from "@tiptap/pm/state";
+import Mention from "@tiptap/extension-mention";
+import Suggestion from "@tiptap/suggestion";
+import { NodeViewWrapper, ReactNodeViewRenderer } from "@tiptap/react";
+import { Avatar } from "@estiva-app/ui";
+import { EnterHint } from "@estiva-app/ui";
+import { inlineChipClassName } from "@estiva-app/ui";
+import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+var PEOPLE_LIMIT = 6;
+function filterPeople(people, query) {
+  const q = query.toLowerCase();
+  return people.filter((person) => q === "" || person.name.toLowerCase().includes(q)).slice(0, PEOPLE_LIMIT);
+}
+function peopleMenu(urgent) {
+  const section = urgent ? "Urgent mention" : "People";
+  return {
+    ariaLabel: section,
+    // The people and the reference lists are the same box: 658px, capped at 360.
+    width: "w-[658px]",
+    maxHeight: "max-h-[360px]",
+    sections: (people) => [{ label: section, items: people, className: "px-3 py-1" }],
+    itemKey: (person) => person.id,
+    row: (person) => ({
+      label: person.name,
+      description: person.description,
+      leading: person.avatar ?? /* @__PURE__ */ jsx3(Avatar, { size: 32, alt: person.name }),
+      hint: /* @__PURE__ */ jsx3(EnterHint, {}),
+      size: "tall"
+    })
+  };
+}
+function optionsOf(editor, name) {
+  return editor.extensionManager.extensions.find((one) => one.name === name)?.options;
+}
+function personSuggestion(urgent, name) {
+  return {
+    ...urgent ? { char: "!@" } : {},
+    items: ({ query, editor }) => filterPeople(optionsOf(editor, name)?.people() ?? [], query),
+    render: suggestionPopup(peopleMenu(urgent)),
+    command: ({ editor, range, props: person }) => {
+      editor.chain().focus().insertContentAt(range, [
+        { type: name, attrs: { id: person.id, label: person.name, pubkey: person.pubkey ?? null } },
+        { type: "text", text: " " }
+      ]).run();
+    }
+  };
+}
+var HEX_KEY = /^[0-9a-f]{64}$/;
+var NOSTR_URI = /^nostr:[a-z0-9]+$/i;
+var fromData = (name, valid) => ({
+  parseHTML: (element) => {
+    const value = element.getAttribute(`data-${name}`);
+    return value !== null && (!valid || valid.test(value)) ? value : null;
+  },
+  // The node's own `renderHTML` writes it.
+  renderHTML: () => ({})
+});
+var personAttributes = () => ({
+  id: { default: null, ...fromData("id") },
+  label: { default: null, ...fromData("label") },
+  /**
+   * The person's Nostr key, when they have one — SPEC §13.1. `id` is the app's
+   * own and means nothing to another app; this is what the body is written
+   * with, so a mention survives a rename.
+   */
+  pubkey: { default: null, ...fromData("pubkey", HEX_KEY) }
+});
+function personData(attrs) {
+  return {
+    "data-id": String(attrs.id ?? ""),
+    "data-label": String(attrs.label ?? ""),
+    ...typeof attrs.pubkey === "string" && attrs.pubkey ? { "data-pubkey": attrs.pubkey } : {}
+  };
+}
+var PersonMention = Mention.extend({
+  name: "mention",
+  addOptions() {
+    return { ...this.parent(), HTMLAttributes: {}, people: () => [], suggestion: personSuggestion(false, this.name) };
+  },
+  addAttributes: personAttributes,
+  renderHTML({ node }) {
+    return ["span", { "data-mention": "true", ...personData(node.attrs), class: inlineChipClassName("person", "cursor-default") }, `@${node.attrs.label}`];
+  },
+  parseHTML() {
+    return [{ tag: "span[data-mention]" }];
+  }
+});
+var UrgentPersonMention = Mention.extend({
+  name: "urgentMention",
+  addOptions() {
+    return { ...this.parent(), HTMLAttributes: {}, people: () => [], suggestion: personSuggestion(true, this.name) };
+  },
+  addAttributes: personAttributes,
+  renderHTML({ node }) {
+    return [
+      "span",
+      { "data-urgent-mention": "true", ...personData(node.attrs), class: inlineChipClassName("urgent", "cursor-default") },
+      `@${node.attrs.label}`
+    ];
+  },
+  parseHTML() {
+    return [{ tag: "span[data-urgent-mention]" }];
+  }
+});
+function urgentPubkeys(editor) {
+  const urgent = [];
+  editor.state.doc.descendants((node) => {
+    if (node.type.name === "urgentMention" && typeof node.attrs.pubkey === "string" && node.attrs.pubkey) urgent.push(node.attrs.pubkey);
+  });
+  return urgent.length > 0 ? urgent : void 0;
+}
+var REFERENCE_LIMIT = 6;
+function filterReferences(items, query) {
+  const q = query.toLowerCase();
+  const shown = q ? items.filter((item) => (item.search ?? item.snippet).toLowerCase().includes(q) || item.label.toLowerCase().includes(q)) : [...items];
+  return shown.slice(-REFERENCE_LIMIT);
+}
+var captionOf = (label, snippet) => snippet ? `${label}: ${snippet}` : label;
+var CaptionedReference = Mention.extend({
+  name: "captionedReference",
+  group: "inline",
+  inline: true,
+  atom: true,
+  addOptions() {
+    return { ...this.parent(), HTMLAttributes: {}, icon: null, suggestion: { char: "\0", items: () => [] } };
+  },
+  addAttributes() {
+    return {
+      id: { default: null, ...fromData("id") },
+      label: { default: null, ...fromData("label") },
+      snippet: { default: "", parseHTML: (element) => element.getAttribute("data-snippet") ?? "", renderHTML: () => ({}) },
+      uri: { default: null, ...fromData("uri", NOSTR_URI) }
+    };
+  },
+  renderHTML({ node }) {
+    return [
+      "span",
+      { [`data-${this.name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`]: "true", "data-id": String(node.attrs.id ?? ""), "data-label": String(node.attrs.label ?? ""), "data-snippet": String(node.attrs.snippet ?? ""), ...node.attrs.uri ? { "data-uri": String(node.attrs.uri) } : {}, class: inlineChipClassName("neutral", "cursor-default") },
+      captionOf(node.attrs.label, node.attrs.snippet)
+    ];
+  },
+  parseHTML() {
+    return [{ tag: `span[data-${this.name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}]` }];
+  },
+  addNodeView() {
+    const icon = this.options.icon;
+    return ReactNodeViewRenderer(
+      ({ node }) => /* @__PURE__ */ jsxs2(NodeViewWrapper, { as: "span", className: inlineChipClassName("neutral", "max-w-[24ch] cursor-default"), children: [
+        /* @__PURE__ */ jsx3("span", { className: "flex items-center justify-center w-4 h-4 shrink-0 text-text-secondary", children: icon }),
+        /* @__PURE__ */ jsx3("span", { className: "truncate", children: captionOf(node.attrs.label, node.attrs.snippet) })
+      ] }),
+      { as: "span" }
+    );
+  }
+});
+function referenceMenu({ ariaLabel, sectionLabel, icon }) {
+  return {
+    ariaLabel,
+    width: "w-[658px]",
+    maxHeight: "max-h-[360px]",
+    sections: (items) => {
+      const groups = [];
+      for (const item of items) {
+        const label = item.section ?? sectionLabel;
+        const last = groups[groups.length - 1];
+        if (last?.label === label) last.items.push(item);
+        else groups.push({ label, items: [item], className: "px-2" });
+      }
+      return groups;
+    },
+    itemKey: (item) => `reference-${item.id}`,
+    row: (item) => ({ leading: icon, label: captionOf(item.label, item.snippet), description: item.description, hint: /* @__PURE__ */ jsx3(EnterHint, {}) })
+  };
+}
+var listed = (options, query) => options.sections ? options.sections(query).flatMap((section) => section.items.map((item) => ({ ...item, section: section.label }))) : filterReferences(options.items(), query);
+var ReferenceTrigger = Extension2.create({
+  name: "referenceTrigger",
+  addOptions() {
+    return { items: () => [], nodeName: "captionedReference", ariaLabel: "References", sectionLabel: "References", icon: null };
+  },
+  addProseMirrorPlugins() {
+    const options = this.options;
+    return [
+      Suggestion({
+        editor: this.editor,
+        char: "[",
+        pluginKey: new PluginKey2("referenceTrigger"),
+        // As a mention's: only where the chip may go.
+        allow: ({ state, range }) => {
+          const type = state.schema.nodes[options.nodeName];
+          return !!type && !!state.doc.resolve(range.from).parent.type.contentMatch.matchType(type);
+        },
+        items: ({ query }) => listed(options, query),
+        render: suggestionPopup({ ...referenceMenu(options), subscribe: options.subscribe, refresh: (query) => listed(options, query) }),
+        command: ({ editor, range, props: item }) => {
+          editor.chain().focus().insertContentAt(range, [
+            { type: options.nodeName, attrs: { id: item.id, label: item.label, snippet: item.snippet, uri: item.uri } },
+            { type: "text", text: " " }
+          ]).run();
+        }
+      })
+    ];
+  }
+});
+var FORMATS = [
+  { id: "paragraph", label: "Text" },
+  { id: "heading", label: "Heading", trigger: "#" },
+  { id: "subheading", label: "Subheading", trigger: "##" },
+  { id: "quote", label: "Quote", trigger: ">" },
+  { id: "code", label: "Code", trigger: "`" },
+  { id: "bulletList", label: "Bulleted list", trigger: "-" },
+  { id: "orderedList", label: "Numbered list", trigger: "1." }
+];
+function applyFormat(editor, id, code = "inline") {
+  const chain = editor.chain().focus();
+  const run = (command, ...args) => {
+    const named = chain[command];
+    return named ? named(...args).run() : false;
+  };
+  switch (id) {
+    case "paragraph":
+      return run("setParagraph");
+    case "heading":
+      return run("setHeading", { level: 1 });
+    case "subheading":
+      return run("setHeading", { level: 2 });
+    case "quote":
+      return run("toggleBlockquote");
+    case "bulletList":
+      return run("toggleBulletList");
+    case "orderedList":
+      return run("toggleOrderedList");
+    case "code":
+      return run(code === "block" ? "toggleCodeBlock" : "toggleCode");
+    default:
+      return false;
+  }
+}
+function formatSection(code = "inline") {
+  return {
+    label: "Format",
+    commands: FORMATS.map((format) => ({
+      key: `format-${format.id}`,
+      row: { label: format.label, shortcut: format.trigger },
+      keywords: [format.id],
+      run: (editor) => {
+        applyFormat(editor, format.id, code);
+      }
+    }))
+  };
+}
+function typeTrigger(input) {
+  return (editor) => {
+    requestAnimationFrame(() => editor.commands.insertContent(input));
+  };
+}
+function matches(command, q) {
+  return [command.row.label, ...command.keywords ?? []].some((text) => text.toLowerCase().includes(q));
+}
+function filterSlashSections(sections, query) {
+  const q = query.toLowerCase();
+  return sections.map((section) => ({ ...section, commands: q ? section.commands.filter((command) => matches(command, q)) : section.commands }));
+}
+var SlashCommands = Extension2.create({
+  name: "slashCommands",
+  addOptions() {
+    return { sections: [formatSection()] };
+  },
+  addProseMirrorPlugins() {
+    const sections = this.options.sections;
+    return [
+      Suggestion({
+        editor: this.editor,
+        char: "/",
+        startOfLine: false,
+        pluginKey: new PluginKey2("slashCommands"),
+        items: ({ query }) => filterSlashSections(sections, query).flatMap((section, at) => section.commands.map((command) => ({ ...command, section: at }))),
+        command: ({ editor, range, props }) => {
+          editor.chain().focus().deleteRange(range).run();
+          props.run(editor);
+        },
+        render: suggestionPopup({
+          ariaLabel: "Commands",
+          width: "w-[300px]",
+          maxHeight: "max-h-[400px]",
+          sections: (rows) => sections.map((section, at) => ({ label: section.label, items: rows.filter((row) => row.section === at) })),
+          itemKey: (row) => row.key,
+          row: (row) => row.row
+        })
+      })
+    ];
+  }
+});
+
 // src/BlockNodes.tsx
-import { Extension as Extension2, Node as Node2 } from "@tiptap/core";
-import { Plugin as Plugin2, PluginKey as PluginKey2 } from "@tiptap/pm/state";
+import { Extension as Extension3, Node as Node2 } from "@tiptap/core";
+import { Plugin as Plugin2, PluginKey as PluginKey3 } from "@tiptap/pm/state";
 import { Mapping, ReplaceAroundStep } from "@tiptap/pm/transform";
-import { NodeViewWrapper, ReactNodeViewRenderer } from "@tiptap/react";
-import { jsx as jsx3 } from "react/jsx-runtime";
+import { NodeViewWrapper as NodeViewWrapper2, ReactNodeViewRenderer as ReactNodeViewRenderer2 } from "@tiptap/react";
+import { jsx as jsx4 } from "react/jsx-runtime";
 var BLOCK_TYPES = [
   "paragraph",
   "heading",
@@ -497,7 +810,7 @@ function bringsInBlocks(transactions) {
     })
   );
 }
-var BlockId = Extension2.create({
+var BlockId = Extension3.create({
   name: "blockId",
   onCreate() {
     const { state, view } = this.editor;
@@ -510,7 +823,7 @@ var BlockId = Extension2.create({
   addProseMirrorPlugins() {
     return [
       new Plugin2({
-        key: new PluginKey2("blockIdSplit"),
+        key: new PluginKey3("blockIdSplit"),
         appendTransaction: (transactions, old, state) => {
           if (!bringsInBlocks(transactions)) return null;
           const mapping = new Mapping();
@@ -569,7 +882,7 @@ var ReferenceNode = Node2.create({
   addNodeView() {
     const View = this.options.view;
     if (!View) return null;
-    return ReactNodeViewRenderer(({ node }) => /* @__PURE__ */ jsx3(NodeViewWrapper, { as: "span", className: "inline", children: /* @__PURE__ */ jsx3(View, { uri: String(node.attrs.uri ?? "") }) }));
+    return ReactNodeViewRenderer2(({ node }) => /* @__PURE__ */ jsx4(NodeViewWrapper2, { as: "span", className: "inline", children: /* @__PURE__ */ jsx4(View, { uri: String(node.attrs.uri ?? "") }) }));
   }
 });
 var UnknownBlock = Node2.create({
@@ -591,14 +904,14 @@ var UnknownBlock = Node2.create({
     return ["div", { "data-unknown-block": String(node.attrs.blockId ?? "") }, String(node.attrs.text ?? "")];
   },
   addNodeView() {
-    return ReactNodeViewRenderer(UnknownBlockView);
+    return ReactNodeViewRenderer2(UnknownBlockView);
   }
 });
 function UnknownBlockView({ node }) {
   const source = node.attrs.source;
   const text = String(node.attrs.text ?? "");
-  return /* @__PURE__ */ jsx3(
-    NodeViewWrapper,
+  return /* @__PURE__ */ jsx4(
+    NodeViewWrapper2,
     {
       "data-block-id": source?.id,
       "data-block-type": source?.type,
@@ -637,19 +950,34 @@ var AttachmentNode = Node2.create({
   addNodeView() {
     const View = this.options.view;
     if (!View) return null;
-    return ReactNodeViewRenderer(({ node }) => /* @__PURE__ */ jsx3(NodeViewWrapper, { className: "my-2", children: /* @__PURE__ */ jsx3(View, { attrs: node.attrs }) }));
+    return ReactNodeViewRenderer2(({ node }) => /* @__PURE__ */ jsx4(NodeViewWrapper2, { className: "my-2", children: /* @__PURE__ */ jsx4(View, { attrs: node.attrs }) }));
   }
 });
 export {
   AttachmentNode,
   BlockId,
+  CaptionedReference,
+  FORMATS,
   KeptSelection,
+  PersonMention,
   ReferenceNode,
+  ReferenceTrigger,
   SelectionToolbar,
+  SlashCommands,
   UnknownBlock,
+  UrgentPersonMention,
+  applyFormat,
+  filterPeople,
+  filterReferences,
+  filterSlashSections,
+  formatSection,
   isSuggestionActive,
   isSuggestionOpen,
   normalizeHref,
-  suggestionPopup
+  peopleMenu,
+  referenceMenu,
+  suggestionPopup,
+  typeTrigger,
+  urgentPubkeys
 };
 //# sourceMappingURL=editor.js.map