@estiva-app/ui 0.67.0 → 0.68.0

package/dist/BlockNodes.d.ts

@@ -44,9 +44,10 @@ import { type Transaction } from '@tiptap/pm/state';
  * loaded from a stored document has none.
  */
 export declare const BlockId: Extension<any, any>;
-/** What a reference's view is handed: the `nostr:` URI it stands for. */
+/** What a reference's view is handed: the `nostr:` URI it stands for, and the URL a URL chip was written as. */
 export interface ReferenceViewProps {
     uri: string;
+    href?: string;
 }
 export interface ReferenceNodeOptions {
     /**
@@ -62,6 +63,16 @@ export interface ReferenceNodeOptions {
  * nobody edits half a `naddr`. Selecting it selects the whole reference, which
  * is also how deleting one works. `marks` carries the run's other marks, so a
  * bold reference comes back bold.
+ *
+ * `embed` is the card its writer chose to draw after its block — `compact`,
+ * `detailed`, or null for none (SPEC §13.3, "A reference's card") — and `extra`
+ * every key of the mark this version does not know. Both are declared so that
+ * ProseMirror keeps them: an undeclared attribute is dropped when the node is
+ * made, and the card with it. `ReferenceCards` draws the cards.
+ *
+ * `href` makes it a **URL chip**: an app URL that reads as the chip of what it
+ * names, and is that URL on the wire (§13.3). `uri` is what it names, filled in
+ * by `LinkChips` once the app has resolved it; until then it draws as the URL.
  */
 export declare const ReferenceNode: Node<ReferenceNodeOptions, any>;
 /**

package/dist/BlockNodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockNodes.d.ts","sourceRoot":"","sources":["../src/BlockNodes.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAa,IAAI,EAAe,MAAM,cAAc,CAAA;AAEtE,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAgRxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,OAAO,qBA+ClB,CAAA;AAEF,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAA;CAC/C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,iCAgCxB,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,gBAqBvB,CAAA;AAgBF,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,8FAA8F;IAC9F,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAA;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,kCAqCzB,CAAA;AAIF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEjE;AAsFD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,qBA+EpB,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,qBAkBlB,CAAA"}
+{"version":3,"file":"BlockNodes.d.ts","sourceRoot":"","sources":["../src/BlockNodes.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,OAAO,CAAA;AACtD,OAAO,EAAE,SAAS,EAAa,IAAI,EAAe,MAAM,cAAc,CAAA;AAEtE,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAiRxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,OAAO,qBA+ClB,CAAA;AAKF,gHAAgH;AAChH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAA;CAC/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,iCA2DxB,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,gBAqBvB,CAAA;AAgBF,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,8FAA8F;IAC9F,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAA;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,kCAqCzB,CAAA;AAIF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEjE;AAsFD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,qBA+EpB,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,qBAkBlB,CAAA"}

package/dist/LinkChips.d.ts

@@ -0,0 +1,82 @@
+/**
+ * An app URL in a document reads as the chip of what it names — SPEC §13.3,
+ * "A reference's card", and §7.7.
+ *
+ * The URL stays the URL: the chip is the `reference` node with `href` set (a
+ * URL chip, `ReferenceNode`), which a document writes back as the URL it was,
+ * plain text with no card and a `link` mark with one. Never a `nostr:`
+ * reference in its place: the URL is how a person addresses the object.
+ *
+ * What a URL names is the app's to say — its manifests and its relay — so the
+ * app hands this extension two functions: `referenceOf`, what it has resolved
+ * so far, and `ask`, to look up the URLs it has not. A URL that names nothing,
+ * or whose answer has not come back, stays text; when `ask` settles the
+ * document is looked at again.
+ *
+ * The URL being typed stays text while the caret is in it or at its end, so a
+ * half-typed address never turns into a chip under the person's fingers. A
+ * pasted URL is whole, so it is asked about and made a chip at once, the caret
+ * still at its end — where `ReferenceMenu` opens its menu.
+ */
+import { Extension, type Editor } from '@tiptap/core';
+import type { Node as PmNode } from '@tiptap/pm/model';
+import { type Selection } from '@tiptap/pm/state';
+export interface LinkChipsOptions {
+    /**
+     * The `nostr:` reference an app URL names, from what the app has resolved
+     * (§7.7) — protocol's `referenceOfLink(url, resolveLink)`. Undefined while it
+     * names nothing, or its answer has not come back.
+     */
+    referenceOf: ((url: string) => string | undefined) | null;
+    /** Look up what these URLs name. When it settles, the document is looked at again. */
+    ask: ((urls: string[]) => Promise<unknown> | void) | null;
+    /**
+     * How many URLs one editor asks about in its life, the first ones; the rest
+     * stay text. An app's answer can cost a relay query, and a document pasted
+     * full of links must not spend the writer's quota. Default 24.
+     */
+    limit: number;
+}
+/** The meta on the transaction that made chips: `{ pasted }`. */
+export declare const CHIPS_MADE = "linkChipsMade";
+interface Found {
+    /** Text URLs that name something: made chips. */
+    chips: {
+        from: number;
+        to: number;
+        url: string;
+        uri: string;
+        marks: string[];
+        pasted: boolean;
+    }[];
+    /** URL chips whose URL is answered now: given their reference. */
+    fills: {
+        pos: number;
+        uri: string;
+    }[];
+    /** Every URL still waiting for an answer, or naming nothing. */
+    open: string[];
+}
+/** Where something was pasted: a URL wholly inside one was not typed, so the caret at its end does not hold it as text. */
+export interface PastedRange {
+    from: number;
+    to: number;
+}
+/**
+ * What to change in a document, and what to ask. `selection` null treats no
+ * URL as being typed; a URL inside one of `pasted` is never being typed.
+ */
+export declare function findLinkChips(doc: PmNode, selection: Selection | null, referenceOf: LinkChipsOptions['referenceOf'], pasted?: readonly PastedRange[]): Found;
+/**
+ * Look at the document again — after the app learned what more URLs name some
+ * other way. Dispatches only when there is a chip to make: an empty
+ * transaction would wake every other plugin (a trailing paragraph appears).
+ */
+export declare function refreshLinkChips(editor: Editor): void;
+/**
+ * Turns the app URLs in a document into URL chips. Pair it with `ReferenceNode`;
+ * `ReferenceCards` then draws a card a URL chip asks for.
+ */
+export declare const LinkChips: Extension<LinkChipsOptions, any>;
+export {};
+//# sourceMappingURL=LinkChips.d.ts.map

package/dist/LinkChips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkChips.d.ts","sourceRoot":"","sources":["../src/LinkChips.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAuC,KAAK,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAExG,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,CAAA;IACzD,sFAAsF;IACtF,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IACzD;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAUD,iEAAiE;AACjE,eAAO,MAAM,UAAU,kBAAkB,CAAA;AA4BzC,UAAU,KAAK;IACb,iDAAiD;IACjD,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACjG,kEAAkE;IAClE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrC,gEAAgE;IAChE,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,2HAA2H;AAC3H,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAE,SAAS,WAAW,EAAO,GAAG,KAAK,CAmChK;AAoBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,kCAyEpB,CAAA"}

package/dist/ReferenceCards.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The cards a block document's writer chose, drawn after the line that holds
+ * each reference — SPEC §13.3, "A reference's card".
+ *
+ * The choice is `embed` on the `reference` node (`ReferenceNode`), so the card
+ * moves and goes with its chip. What a card looks like is the app's — it knows
+ * how to resolve an object and draw its row or its card — so this extension
+ * draws nothing itself: after every textblock whose chips ask for a card it
+ * places one empty, non-editable slot, and `useReferenceCards` hands the app
+ * those slots to portal its cards into. A portal, rather than a React root per
+ * slot, keeps the app's providers around the card.
+ *
+ * **A slot keeps its element while its block lives.** It is keyed by the
+ * nearest block id (the `blockId` attribute), so typing above a card does not
+ * re-make its element, and the card does not reload on every keystroke.
+ *
+ * The slot sits at the end of the textblock, inside it: a paragraph's card is
+ * under the paragraph, a list item's under the item at its indent, a table
+ * cell's in the cell.
+ */
+import { Extension, type Editor } from '@tiptap/core';
+import type { Node as PmNode } from '@tiptap/pm/model';
+import { type EditorState } from '@tiptap/pm/state';
+/** A layout a writer can choose; `none` is no card. */
+export type ReferenceCardLayout = 'none' | 'compact' | 'detailed';
+/** One card to draw: the reference's `nostr:` URI and how much to show. */
+export interface ReferenceCard {
+    uri: string;
+    layout: Exclude<ReferenceCardLayout, 'none'>;
+}
+/** One slot: where an app draws the cards of one line. */
+export interface ReferenceCardSlot {
+    key: string;
+    element: HTMLElement;
+    cards: ReferenceCard[];
+}
+interface Placement {
+    key: string;
+    /** The end of the textblock's content, where the slot goes. */
+    pos: number;
+    cards: ReferenceCard[];
+}
+/** Every line that asks for a card, in document order. */
+export declare function referenceCardPlacements(doc: PmNode): Placement[];
+interface ReferenceCardsStorage {
+    /** One element per slot key, made once and reused, so the app's portal stays put. */
+    elements: Map<string, HTMLElement>;
+}
+/**
+ * Places a slot after each line whose chips ask for a card. Pair it with
+ * `ReferenceNode`, and draw the cards with `useReferenceCards`.
+ */
+export declare const ReferenceCards: Extension<Record<string, never>, ReferenceCardsStorage>;
+/**
+ * The slots to draw cards into, kept current as the document changes. Draw
+ * each with `createPortal(<cards/>, slot.element)`, keyed by `slot.key`.
+ */
+export declare function useReferenceCards(editor: Editor | null): ReferenceCardSlot[];
+/**
+ * The chip the person has selected, with what it names and its card — or null.
+ *
+ * Selected as a node (a click, where a click on the chip does not follow its
+ * link), or inside a selected range that holds that one chip and nothing but
+ * spaces besides (Shift+arrow over it, or a drag across it): an app whose chip
+ * is a link has no other way to select it.
+ */
+export declare function referenceAtSelection(state: EditorState): {
+    pos: number;
+    uri: string;
+    layout: ReferenceCardLayout;
+} | null;
+/** Sets the card of the selected chip. `none` removes it. The selection stays as it was. */
+export declare function setReferenceCard(editor: Editor, layout: ReferenceCardLayout): boolean;
+/** Sets the card of the chip at `pos` — one that names something. `none` removes it. The selection stays as it was. */
+export declare function setReferenceCardAt(editor: Editor, pos: number, layout: ReferenceCardLayout): boolean;
+export {};
+//# sourceMappingURL=ReferenceCards.d.ts.map

package/dist/ReferenceCards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceCards.d.ts","sourceRoot":"","sources":["../src/ReferenceCards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAIrF,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjE,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAQD,0DAA0D;AAC1D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAuBhE;AAED,UAAU,qBAAqB;IAC7B,qFAAqF;IACrF,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAmBD;;;GAGG;AACH,eAAO,MAAM,cAAc,yDA+BzB,CAAA;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,EAAE,CAyB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CA2BzH;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAGrF;AAED,uHAAuH;AACvH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CASpG"}

package/dist/ReferenceMenu.d.ts

@@ -0,0 +1,18 @@
+import { Extension, type Editor } from '@tiptap/core';
+import { type EditorState } from '@tiptap/pm/state';
+/** Whether the menu is open, for an editor's own Escape: while it is, Escape closes it rather than leaving. */
+export declare function isReferenceMenuOpen(state: EditorState): boolean;
+/**
+ * A click on the chip at `pos`, from its node view: while editing, with the
+ * menu installed, it opens the menu, and the caller stops the click there.
+ * Returns false when the click should go on to the chip.
+ */
+export declare function referenceMenuClick(editor: Editor, pos: number): boolean;
+/** Which chip the menu is open on: see the module comment. */
+export declare const ReferenceMenu: Extension<any, any>;
+export interface ReferenceMenuViewProps {
+    editor: Editor | null;
+}
+/** The menu `ReferenceMenu` holds, hung under its chip. Render it always, beside `EditorContent`. */
+export declare function ReferenceMenuView({ editor }: ReferenceMenuViewProps): import("react").JSX.Element;
+//# sourceMappingURL=ReferenceMenu.d.ts.map

package/dist/ReferenceMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceMenu.d.ts","sourceRoot":"","sources":["../src/ReferenceMenu.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAAmD,KAAK,WAAW,EAAoB,MAAM,kBAAkB,CAAA;AAmHtH,+GAA+G;AAC/G,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvE;AAWD,8DAA8D;AAC9D,eAAO,MAAM,aAAa,qBAuExB,CAAA;AAUF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,sBAAsB,+BAyFnE"}

package/dist/RichText.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * Formatted text, drawn: headings, paragraphs, lists, a quote, code, a divider,
  * a table and links.
@@ -75,6 +75,13 @@ export interface RichTextProps {
      * `undefined` to leave it to the part, which draws its words.
      */
     renderBlock?: (block: RichTextBlock) => ReactNode | undefined;
+    /**
+     * Draws something after a line of text: after a paragraph, a heading or a
+     * quote, and inside a list item or a table cell after its words — where a
+     * document's chip asks for its card (SPEC §13.3). Asked of every such line;
+     * return nothing for most.
+     */
+    renderAfter?: (block: RichTextBlock) => ReactNode;
     /**
      * Ticks or unticks a checklist item, by its block id: its box is then a
      * control, one click where the text is read. Without it the box is a picture
@@ -89,5 +96,5 @@ export interface RichTextProps {
 export declare function richTextClassName(size?: RichTextSize, className?: string): string;
 /** The tone a callout is drawn in: its own, or `note` for one this part does not know (§13.3). */
 export declare function calloutLook(tone: string): string;
-export declare function RichText({ blocks, size, renderText, renderReference, renderBlock, onTick, }: RichTextProps): import("react").JSX.Element | null;
+export declare function RichText({ blocks, size, renderText, renderReference, renderBlock, renderAfter, onTick, }: RichTextProps): import("react").JSX.Element | null;
 //# sourceMappingURL=RichText.d.ts.map

package/dist/RichText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../src/RichText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,OAAO,CAAA;AAMlD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kHAAkH;IAClH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;IACxC,mEAAmE;IACnE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,SAAS,CAAA;IACpE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAA;IAC7D;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD;AA6CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,YAAwB,EAAE,SAAS,CAAC,EAAE,MAAM,UAGnF;AAkDD,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAuMD,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,IAAgB,EAChB,UAA2B,EAC3B,eAA+C,EAC/C,WAAW,EACX,MAAM,GACP,EAAE,aAAa,sCAQf"}
+{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../src/RichText.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kHAAkH;IAClH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;IACxC,mEAAmE;IACnE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,SAAS,CAAA;IACpE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAA;IAC7D;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,CAAA;IACjD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD;AA6CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,YAAwB,EAAE,SAAS,CAAC,EAAE,MAAM,UAGnF;AAmDD,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AA6ND,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,IAAgB,EAChB,UAA2B,EAC3B,eAA+C,EAC/C,WAAW,EACX,WAAW,EACX,MAAM,GACP,EAAE,aAAa,sCAQf"}

package/dist/SelectionToolbar.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import type { Editor } from '@tiptap/react';
 import { Extension } from '@tiptap/core';
 import { PluginKey } from '@tiptap/pm/state';
@@ -57,6 +58,13 @@ export interface SelectionToolbarProps {
     marks?: readonly MarkId[];
     /** The Link button and its address field. Needs a link mark in the editor and `KeptSelection`. Default off. */
     link?: boolean;
+    /**
+     * More of the strip, after the marks: the app's own `ToolbarButton`s for what
+     * is selected — a chip's card, say. Each keeps the selection by preventing
+     * its press's default, as the marks do. Nothing is added when it renders
+     * nothing.
+     */
+    children?: ReactNode;
 }
-export declare function SelectionToolbar({ editor, marks, link }: SelectionToolbarProps): import("react").JSX.Element | null;
+export declare function SelectionToolbar({ editor, marks, link, children }: SelectionToolbarProps): import("react").JSX.Element | null;
 //# sourceMappingURL=SelectionToolbar.d.ts.map

package/dist/SelectionToolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionToolbar.d.ts","sourceRoot":"","sources":["../src/SelectionToolbar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAA;AASpD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,6BAAmD,CAAA;AAEhF,mGAAmG;AACnG,eAAO,MAAM,aAAa,qBA8BxB,CAAA;AAEF,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,QAG3C;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,QAG9C;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE9D;AAED,wGAAwG;AACxG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAkB7D,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9D;AA2ED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,+GAA+G;IAC/G,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAuC,EAAE,IAAY,EAAE,EAAE,qBAAqB,sCAqQxH"}
+{"version":3,"file":"SelectionToolbar.d.ts","sourceRoot":"","sources":["../src/SelectionToolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAA;AASpD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,6BAAmD,CAAA;AAEhF,mGAAmG;AACnG,eAAO,MAAM,aAAa,qBA8BxB,CAAA;AAEF,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,QAG3C;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,QAG9C;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE9D;AAED,wGAAwG;AACxG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAkB7D,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9D;AA2ED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,+GAA+G;IAC/G,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAuC,EAAE,IAAY,EAAE,QAAQ,EAAE,EAAE,qBAAqB,sCAsQlI"}

package/dist/editor.d.ts

@@ -15,4 +15,7 @@ export { EditorBlockHandle, blockDropCursor, deleteBlock, moveBlock, duplicateBl
 export { EditorTableControls, appendTableRow, appendTableColumn, deleteTableRow, deleteTableColumn, type EditorTableControlsProps } from './EditorTableControls';
 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, Checklist, Callout, isChecklistTick, UnknownBlock, ReferenceNode, AttachmentNode, type ReferenceNodeOptions, type ReferenceViewProps, type AttachmentNodeOptions, type AttachmentViewProps, } from './BlockNodes';
+export { ReferenceCards, useReferenceCards, referenceAtSelection, referenceCardPlacements, setReferenceCard, setReferenceCardAt, type ReferenceCard, type ReferenceCardLayout, type ReferenceCardSlot, } from './ReferenceCards';
+export { LinkChips, findLinkChips, refreshLinkChips, type LinkChipsOptions, type PastedRange } from './LinkChips';
+export { ReferenceMenu, ReferenceMenuView, isReferenceMenuOpen, referenceMenuClick, type ReferenceMenuViewProps } from './ReferenceMenu';
 //# 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,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC5H,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AACtH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,sBAAsB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACjL,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChK,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,SAAS,EACT,OAAO,EACP,eAAe,EACf,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,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC5H,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AACtH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,sBAAsB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACjL,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChK,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,SAAS,EACT,OAAO,EACP,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AACjH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA"}