@athenaintel/react 0.57.1 → 0.59.0

package/dist/chat-ui/composer/slash-command-menu.js

@@ -0,0 +1,143 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { forwardRef, useId, useRef, useState, useEffect, useImperativeHandle } from "react";
+import { slashCommandRows } from "./slash-commands.js";
+import { cn } from "cnfast";
+function slashCommandRuns(command) {
+  return !command.disabledReason;
+}
+const SlashCommandMenu = forwardRef(
+  ({ sections, onPick }, ref) => {
+    const rows = slashCommandRows(sections);
+    const listId = useId();
+    const selectedRef = useRef(null);
+    const rowsKey = rows.map((row) => row.command.name).join("\0");
+    const [selection, setSelection] = useState({ rowsKey, index: 0 });
+    const current = selection.rowsKey === rowsKey ? Math.min(selection.index, Math.max(rows.length - 1, 0)) : 0;
+    const setSelected = (index2) => setSelection({ rowsKey, index: index2 });
+    useEffect(() => {
+      var _a, _b;
+      (_b = (_a = selectedRef.current) == null ? void 0 : _a.scrollIntoView) == null ? void 0 : _b.call(_a, { block: "nearest" });
+    }, [current]);
+    const pick = (match) => {
+      if (match && slashCommandRuns(match.command)) onPick(match);
+    };
+    useImperativeHandle(
+      ref,
+      () => ({
+        onKeyDown: (event) => {
+          if (rows.length === 0) return false;
+          switch (event.key) {
+            case "ArrowDown":
+              setSelected((current + 1) % rows.length);
+              return true;
+            case "ArrowUp":
+              setSelected((current - 1 + rows.length) % rows.length);
+              return true;
+            case "Enter":
+            case "NumpadEnter":
+            case "Tab":
+              if (event.isComposing) return false;
+              pick(rows[current]);
+              return true;
+            default:
+              return false;
+          }
+        }
+      }),
+      [current, rows]
+    );
+    if (rows.length === 0) return null;
+    let index = -1;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        id: listId,
+        role: "listbox",
+        "aria-label": "Commands",
+        "data-testid": "composer-slash-menu",
+        className: "max-h-80 min-w-[260px] max-w-[380px] overflow-y-auto rounded-md border bg-popover p-1 text-popover-foreground shadow-lg",
+        children: sections.map((section) => (
+          // A group of the listbox's options, named by its heading.
+          /* @__PURE__ */ jsxs(
+            "fieldset",
+            {
+              "aria-label": section.title ?? void 0,
+              className: "m-0 min-w-0 border-0 p-0 py-0.5",
+              children: [
+                section.title ? /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    "aria-hidden": true,
+                    className: "px-2 pb-0.5 pt-1.5 font-medium text-[11px] text-muted-foreground uppercase tracking-wide",
+                    children: section.title
+                  }
+                ) : null,
+                section.matches.map((match) => {
+                  index += 1;
+                  const rowIndex = index;
+                  const isSelected = rowIndex === current;
+                  const { command } = match;
+                  const runs = slashCommandRuns(command);
+                  const Icon = command.icon;
+                  return /* @__PURE__ */ jsxs(
+                    "div",
+                    {
+                      ref: isSelected ? selectedRef : void 0,
+                      role: "option",
+                      "aria-selected": isSelected,
+                      "aria-disabled": !runs || void 0,
+                      "data-command": command.name,
+                      tabIndex: -1,
+                      onMouseMove: () => setSelected(rowIndex),
+                      onClick: () => pick(match),
+                      onKeyDown: (event) => {
+                        if (event.key !== "Enter" && event.key !== " ") return;
+                        event.preventDefault();
+                        pick(match);
+                      },
+                      className: cn(
+                        "flex cursor-pointer items-start gap-2 rounded px-2 py-1.5",
+                        isSelected && "bg-muted",
+                        !runs && "cursor-default"
+                      ),
+                      children: [
+                        Icon ? /* @__PURE__ */ jsx(
+                          Icon,
+                          {
+                            "aria-hidden": true,
+                            className: cn("mt-0.5 size-4 shrink-0 text-muted-foreground", !runs && "opacity-50")
+                          }
+                        ) : null,
+                        /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+                          /* @__PURE__ */ jsxs("span", { className: cn("truncate text-sm leading-tight", !runs && "text-muted-foreground"), children: [
+                            command.label,
+                            match.args ? /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground", children: [
+                              " ",
+                              match.args
+                            ] }) : command.args ? /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground italic", children: [
+                              " ",
+                              command.args
+                            ] }) : null
+                          ] }),
+                          /* @__PURE__ */ jsx("span", { className: "mt-0.5 truncate text-muted-foreground text-xs leading-tight", children: runs ? command.description : command.disabledReason })
+                        ] })
+                      ]
+                    },
+                    command.name
+                  );
+                })
+              ]
+            },
+            section.title ?? ""
+          )
+        ))
+      }
+    );
+  }
+);
+SlashCommandMenu.displayName = "SlashCommandMenu";
+export {
+  SlashCommandMenu,
+  slashCommandRuns
+};
+//# sourceMappingURL=slash-command-menu.js.map

package/dist/chat-ui/composer/slash-command-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command-menu.js","sources":["../../../src/chat-ui/composer/slash-command-menu.tsx"],"sourcesContent":["/**\n * The composer's `/` menu: the commands what is typed finds, under their\n * groups, with the keyboard in the editor (arrows move, Enter or Tab picks,\n * Escape closes, as the `@` menu works). A command that can't run right now\n * lists greyed with its reason and picks nothing.\n */\n\nimport { forwardRef, useEffect, useId, useImperativeHandle, useRef, useState } from 'react';\nimport { cn } from '../../lib/utils';\nimport {\n  type ComposerSlashCommand,\n  type SlashCommandMatch,\n  type SlashCommandSection,\n  slashCommandRows,\n} from './slash-commands';\n\nexport interface SlashCommandMenuHandle {\n  /** A key from the editor while the menu is open; `true` when the menu took it. */\n  onKeyDown: (event: KeyboardEvent) => boolean;\n}\n\nexport interface SlashCommandMenuProps {\n  sections: readonly SlashCommandSection[];\n  /** Picks a row whose command can run. */\n  onPick: (match: SlashCommandMatch) => void;\n}\n\n/** Whether a command can run now (no reason it can't). */\nexport function slashCommandRuns(command: ComposerSlashCommand): boolean {\n  return !command.disabledReason;\n}\n\nexport const SlashCommandMenu = forwardRef<SlashCommandMenuHandle, SlashCommandMenuProps>(\n  ({ sections, onPick }, ref) => {\n    const rows = slashCommandRows(sections);\n    const listId = useId();\n    const selectedRef = useRef<HTMLDivElement>(null);\n    // The selection belongs to the rows it was made in: a query that lists\n    // other rows starts it over at the best match.\n    const rowsKey = rows.map((row) => row.command.name).join('\\u0000');\n    const [selection, setSelection] = useState({ rowsKey, index: 0 });\n    const current =\n      selection.rowsKey === rowsKey ? Math.min(selection.index, Math.max(rows.length - 1, 0)) : 0;\n    const setSelected = (index: number) => setSelection({ rowsKey, index });\n    useEffect(() => {\n      selectedRef.current?.scrollIntoView?.({ block: 'nearest' });\n    }, [current]);\n\n    const pick = (match: SlashCommandMatch | undefined) => {\n      if (match && slashCommandRuns(match.command)) onPick(match);\n    };\n\n    useImperativeHandle(\n      ref,\n      () => ({\n        onKeyDown: (event: KeyboardEvent): boolean => {\n          if (rows.length === 0) return false;\n          switch (event.key) {\n            case 'ArrowDown':\n              setSelected((current + 1) % rows.length);\n              return true;\n            case 'ArrowUp':\n              setSelected((current - 1 + rows.length) % rows.length);\n              return true;\n            case 'Enter':\n            case 'NumpadEnter':\n            case 'Tab':\n              // An input method's Enter confirms its text, never a command.\n              if (event.isComposing) return false;\n              // Taken even for a command that can't run, so it sends nothing either.\n              pick(rows[current]);\n              return true;\n            default:\n              return false;\n          }\n        },\n      }),\n      [current, rows],\n    );\n\n    if (rows.length === 0) return null;\n    let index = -1;\n    return (\n      <div\n        id={listId}\n        role=\"listbox\"\n        aria-label=\"Commands\"\n        data-testid=\"composer-slash-menu\"\n        className=\"max-h-80 min-w-[260px] max-w-[380px] overflow-y-auto rounded-md border bg-popover p-1 text-popover-foreground shadow-lg\"\n      >\n        {sections.map((section) => (\n          // A group of the listbox's options, named by its heading.\n          <fieldset\n            key={section.title ?? ''}\n            aria-label={section.title ?? undefined}\n            className=\"m-0 min-w-0 border-0 p-0 py-0.5\"\n          >\n            {section.title ? (\n              <div\n                aria-hidden\n                className=\"px-2 pb-0.5 pt-1.5 font-medium text-[11px] text-muted-foreground uppercase tracking-wide\"\n              >\n                {section.title}\n              </div>\n            ) : null}\n            {section.matches.map((match) => {\n              index += 1;\n              const rowIndex = index;\n              const isSelected = rowIndex === current;\n              const { command } = match;\n              const runs = slashCommandRuns(command);\n              const Icon = command.icon;\n              return (\n                <div\n                  key={command.name}\n                  ref={isSelected ? selectedRef : undefined}\n                  role=\"option\"\n                  aria-selected={isSelected}\n                  aria-disabled={!runs || undefined}\n                  data-command={command.name}\n                  tabIndex={-1}\n                  // Opening or scrolling the menu can place a row under a still\n                  // pointer: only a moving one takes the selection from the keyboard.\n                  onMouseMove={() => setSelected(rowIndex)}\n                  onClick={() => pick(match)}\n                  // The keyboard reaches the menu through the editor; an option\n                  // focused some other way (assistive technology) picks the same.\n                  onKeyDown={(event) => {\n                    if (event.key !== 'Enter' && event.key !== ' ') return;\n                    event.preventDefault();\n                    pick(match);\n                  }}\n                  className={cn(\n                    'flex cursor-pointer items-start gap-2 rounded px-2 py-1.5',\n                    isSelected && 'bg-muted',\n                    !runs && 'cursor-default',\n                  )}\n                >\n                  {Icon ? (\n                    <Icon\n                      aria-hidden\n                      className={cn('mt-0.5 size-4 shrink-0 text-muted-foreground', !runs && 'opacity-50')}\n                    />\n                  ) : null}\n                  <span className=\"flex min-w-0 flex-1 flex-col\">\n                    <span className={cn('truncate text-sm leading-tight', !runs && 'text-muted-foreground')}>\n                      {command.label}\n                      {match.args ? (\n                        <span className=\"text-muted-foreground\"> {match.args}</span>\n                      ) : command.args ? (\n                        <span className=\"text-muted-foreground italic\"> {command.args}</span>\n                      ) : null}\n                    </span>\n                    <span className=\"mt-0.5 truncate text-muted-foreground text-xs leading-tight\">\n                      {runs ? command.description : command.disabledReason}\n                    </span>\n                  </span>\n                </div>\n              );\n            })}\n          </fieldset>\n        ))}\n      </div>\n    );\n  },\n);\n\nSlashCommandMenu.displayName = 'SlashCommandMenu';\n"],"names":["index"],"mappings":"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"}

package/dist/chat-ui/composer/slash-commands-extension.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@tiptap/core");
+const state = require("@tiptap/pm/state");
+const Suggestion = require("@tiptap/suggestion");
+const SLASH_COMMANDS_PLUGIN_KEY = new state.PluginKey("athenaComposerSlashCommands");
+const SlashCommandsExtension = core.Extension.create({
+  name: "athenaComposerSlashCommands",
+  addOptions() {
+    return {
+      hasCommands: () => false,
+      callbacks: null,
+      onPick: () => {
+      }
+    };
+  },
+  addProseMirrorPlugins() {
+    const { callbacks, hasCommands, onPick } = this.options;
+    const propsOf = (props) => ({
+      query: props.query,
+      clientRect: props.clientRect ?? null,
+      pick: props.command
+    });
+    return [
+      Suggestion({
+        editor: this.editor,
+        pluginKey: SLASH_COMMANDS_PLUGIN_KEY,
+        char: "/",
+        // Arguments follow a command's name (`/open budget`).
+        allowSpaces: true,
+        // At the start of a line, or after a space: `and/or` and a URL's path are no commands.
+        startOfLine: false,
+        allowedPrefixes: [" ", " "],
+        allow: () => hasCommands(),
+        items: () => [],
+        command: ({ editor, range, props }) => {
+          onPick({ editor, range, match: props });
+        },
+        render: () => ({
+          onStart: (props) => callbacks == null ? void 0 : callbacks.onStart(propsOf(props)),
+          onUpdate: (props) => callbacks == null ? void 0 : callbacks.onUpdate(propsOf(props)),
+          onKeyDown: ({ event }) => (callbacks == null ? void 0 : callbacks.onKeyDown(event)) ?? false,
+          onExit: () => callbacks == null ? void 0 : callbacks.onExit()
+        })
+      })
+    ];
+  }
+});
+exports.SLASH_COMMANDS_PLUGIN_KEY = SLASH_COMMANDS_PLUGIN_KEY;
+exports.SlashCommandsExtension = SlashCommandsExtension;
+//# sourceMappingURL=slash-commands-extension.cjs.map

package/dist/chat-ui/composer/slash-commands-extension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands-extension.cjs","sources":["../../../src/chat-ui/composer/slash-commands-extension.ts"],"sourcesContent":["/**\n * The composer's `/` trigger: Tiptap's suggestion plugin, as the `@` menu uses\n * it (`MentionSuggestionsExtension`), under a plugin key of its own so the two\n * menus never share state. The extension owns the trigger only; the composer\n * renders the menu (`SlashCommandMenu`) from the callbacks and runs what is\n * picked (`onPick`).\n */\n\nimport { type Editor, Extension, type Range } from '@tiptap/core';\nimport { PluginKey } from '@tiptap/pm/state';\nimport Suggestion from '@tiptap/suggestion';\nimport type { SlashCommandMatch } from './slash-commands';\n\n/** What the menu needs from the open suggestion. */\nexport interface SlashCommandSuggestionProps {\n  /** What is typed after the `/`, spaces included. */\n  query: string;\n  /** Where the typed `/query` sits, for the popup to follow. */\n  clientRect: (() => DOMRect | null) | null;\n  /** Picks a row: the plugin hands it to `onPick` with the `/query`'s range. */\n  pick: (match: SlashCommandMatch) => void;\n}\n\nexport interface SlashCommandSuggestionCallbacks {\n  onStart: (props: SlashCommandSuggestionProps) => void;\n  onUpdate: (props: SlashCommandSuggestionProps) => void;\n  /** A key while the suggestion is active; `true` when the menu took it. */\n  onKeyDown: (event: KeyboardEvent) => boolean;\n  onExit: () => void;\n}\n\nexport interface SlashCommandsExtensionOptions {\n  /** Whether the composer has any command now (read as the trigger is typed): none, no menu. */\n  hasCommands: () => boolean;\n  callbacks: SlashCommandSuggestionCallbacks | null;\n  /** Runs a picked command over the `/query` it was picked from. */\n  onPick: (pick: { editor: Editor; range: Range; match: SlashCommandMatch }) => void;\n}\n\nexport const SLASH_COMMANDS_PLUGIN_KEY = new PluginKey('athenaComposerSlashCommands');\n\nexport const SlashCommandsExtension = Extension.create<SlashCommandsExtensionOptions>({\n  name: 'athenaComposerSlashCommands',\n\n  addOptions() {\n    return {\n      hasCommands: () => false,\n      callbacks: null,\n      onPick: () => {},\n    };\n  },\n\n  addProseMirrorPlugins() {\n    const { callbacks, hasCommands, onPick } = this.options;\n    const propsOf = (props: {\n      query: string;\n      clientRect?: (() => DOMRect | null) | null;\n      command: (match: SlashCommandMatch) => void;\n    }): SlashCommandSuggestionProps => ({\n      query: props.query,\n      clientRect: props.clientRect ?? null,\n      pick: props.command,\n    });\n\n    return [\n      Suggestion<SlashCommandMatch, SlashCommandMatch>({\n        editor: this.editor,\n        pluginKey: SLASH_COMMANDS_PLUGIN_KEY,\n        char: '/',\n        // Arguments follow a command's name (`/open budget`).\n        allowSpaces: true,\n        // At the start of a line, or after a space: `and/or` and a URL's path are no commands.\n        startOfLine: false,\n        allowedPrefixes: [' ', ' '],\n        allow: () => hasCommands(),\n        items: () => [],\n        command: ({ editor, range, props }) => {\n          onPick({ editor, range, match: props });\n        },\n        render: () => ({\n          onStart: (props) => callbacks?.onStart(propsOf(props)),\n          onUpdate: (props) => callbacks?.onUpdate(propsOf(props)),\n          onKeyDown: ({ event }) => callbacks?.onKeyDown(event) ?? false,\n          onExit: () => callbacks?.onExit(),\n        }),\n      }),\n    ];\n  },\n});\n"],"names":["PluginKey","Extension"],"mappings":";;;;;AAuCO,MAAM,4BAA4B,IAAIA,MAAAA,UAAU,6BAA6B;AAE7E,MAAM,yBAAyBC,KAAAA,UAAU,OAAsC;AAAA,EACpF,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,aAAa,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,QAAQ,MAAM;AAAA,MAAC;AAAA,IAAA;AAAA,EAEnB;AAAA,EAEA,wBAAwB;AACtB,UAAM,EAAE,WAAW,aAAa,OAAA,IAAW,KAAK;AAChD,UAAM,UAAU,CAAC,WAImB;AAAA,MAClC,OAAO,MAAM;AAAA,MACb,YAAY,MAAM,cAAc;AAAA,MAChC,MAAM,MAAM;AAAA,IAAA;AAGd,WAAO;AAAA,MACL,WAAiD;AAAA,QAC/C,QAAQ,KAAK;AAAA,QACb,WAAW;AAAA,QACX,MAAM;AAAA;AAAA,QAEN,aAAa;AAAA;AAAA,QAEb,aAAa;AAAA,QACb,iBAAiB,CAAC,KAAK,GAAG;AAAA,QAC1B,OAAO,MAAM,YAAA;AAAA,QACb,OAAO,MAAM,CAAA;AAAA,QACb,SAAS,CAAC,EAAE,QAAQ,OAAO,YAAY;AACrC,iBAAO,EAAE,QAAQ,OAAO,OAAO,OAAO;AAAA,QACxC;AAAA,QACA,QAAQ,OAAO;AAAA,UACb,SAAS,CAAC,UAAU,uCAAW,QAAQ,QAAQ,KAAK;AAAA,UACpD,UAAU,CAAC,UAAU,uCAAW,SAAS,QAAQ,KAAK;AAAA,UACtD,WAAW,CAAC,EAAE,MAAA,OAAY,uCAAW,UAAU,WAAU;AAAA,UACzD,QAAQ,MAAM,uCAAW;AAAA,QAAO;AAAA,MAClC,CACD;AAAA,IAAA;AAAA,EAEL;AACF,CAAC;;;"}

package/dist/chat-ui/composer/slash-commands-extension.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The composer's `/` trigger: Tiptap's suggestion plugin, as the `@` menu uses
+ * it (`MentionSuggestionsExtension`), under a plugin key of its own so the two
+ * menus never share state. The extension owns the trigger only; the composer
+ * renders the menu (`SlashCommandMenu`) from the callbacks and runs what is
+ * picked (`onPick`).
+ */
+import { type Editor, Extension, type Range } from '@tiptap/core';
+import { PluginKey } from '@tiptap/pm/state';
+import type { SlashCommandMatch } from './slash-commands';
+/** What the menu needs from the open suggestion. */
+export interface SlashCommandSuggestionProps {
+    /** What is typed after the `/`, spaces included. */
+    query: string;
+    /** Where the typed `/query` sits, for the popup to follow. */
+    clientRect: (() => DOMRect | null) | null;
+    /** Picks a row: the plugin hands it to `onPick` with the `/query`'s range. */
+    pick: (match: SlashCommandMatch) => void;
+}
+export interface SlashCommandSuggestionCallbacks {
+    onStart: (props: SlashCommandSuggestionProps) => void;
+    onUpdate: (props: SlashCommandSuggestionProps) => void;
+    /** A key while the suggestion is active; `true` when the menu took it. */
+    onKeyDown: (event: KeyboardEvent) => boolean;
+    onExit: () => void;
+}
+export interface SlashCommandsExtensionOptions {
+    /** Whether the composer has any command now (read as the trigger is typed): none, no menu. */
+    hasCommands: () => boolean;
+    callbacks: SlashCommandSuggestionCallbacks | null;
+    /** Runs a picked command over the `/query` it was picked from. */
+    onPick: (pick: {
+        editor: Editor;
+        range: Range;
+        match: SlashCommandMatch;
+    }) => void;
+}
+export declare const SLASH_COMMANDS_PLUGIN_KEY: PluginKey<any>;
+export declare const SlashCommandsExtension: Extension<SlashCommandsExtensionOptions, any>;

package/dist/chat-ui/composer/slash-commands-extension.js

@@ -0,0 +1,51 @@
+import { Extension } from "@tiptap/core";
+import { PluginKey } from "@tiptap/pm/state";
+import Suggestion from "@tiptap/suggestion";
+const SLASH_COMMANDS_PLUGIN_KEY = new PluginKey("athenaComposerSlashCommands");
+const SlashCommandsExtension = Extension.create({
+  name: "athenaComposerSlashCommands",
+  addOptions() {
+    return {
+      hasCommands: () => false,
+      callbacks: null,
+      onPick: () => {
+      }
+    };
+  },
+  addProseMirrorPlugins() {
+    const { callbacks, hasCommands, onPick } = this.options;
+    const propsOf = (props) => ({
+      query: props.query,
+      clientRect: props.clientRect ?? null,
+      pick: props.command
+    });
+    return [
+      Suggestion({
+        editor: this.editor,
+        pluginKey: SLASH_COMMANDS_PLUGIN_KEY,
+        char: "/",
+        // Arguments follow a command's name (`/open budget`).
+        allowSpaces: true,
+        // At the start of a line, or after a space: `and/or` and a URL's path are no commands.
+        startOfLine: false,
+        allowedPrefixes: [" ", " "],
+        allow: () => hasCommands(),
+        items: () => [],
+        command: ({ editor, range, props }) => {
+          onPick({ editor, range, match: props });
+        },
+        render: () => ({
+          onStart: (props) => callbacks == null ? void 0 : callbacks.onStart(propsOf(props)),
+          onUpdate: (props) => callbacks == null ? void 0 : callbacks.onUpdate(propsOf(props)),
+          onKeyDown: ({ event }) => (callbacks == null ? void 0 : callbacks.onKeyDown(event)) ?? false,
+          onExit: () => callbacks == null ? void 0 : callbacks.onExit()
+        })
+      })
+    ];
+  }
+});
+export {
+  SLASH_COMMANDS_PLUGIN_KEY,
+  SlashCommandsExtension
+};
+//# sourceMappingURL=slash-commands-extension.js.map

package/dist/chat-ui/composer/slash-commands-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands-extension.js","sources":["../../../src/chat-ui/composer/slash-commands-extension.ts"],"sourcesContent":["/**\n * The composer's `/` trigger: Tiptap's suggestion plugin, as the `@` menu uses\n * it (`MentionSuggestionsExtension`), under a plugin key of its own so the two\n * menus never share state. The extension owns the trigger only; the composer\n * renders the menu (`SlashCommandMenu`) from the callbacks and runs what is\n * picked (`onPick`).\n */\n\nimport { type Editor, Extension, type Range } from '@tiptap/core';\nimport { PluginKey } from '@tiptap/pm/state';\nimport Suggestion from '@tiptap/suggestion';\nimport type { SlashCommandMatch } from './slash-commands';\n\n/** What the menu needs from the open suggestion. */\nexport interface SlashCommandSuggestionProps {\n  /** What is typed after the `/`, spaces included. */\n  query: string;\n  /** Where the typed `/query` sits, for the popup to follow. */\n  clientRect: (() => DOMRect | null) | null;\n  /** Picks a row: the plugin hands it to `onPick` with the `/query`'s range. */\n  pick: (match: SlashCommandMatch) => void;\n}\n\nexport interface SlashCommandSuggestionCallbacks {\n  onStart: (props: SlashCommandSuggestionProps) => void;\n  onUpdate: (props: SlashCommandSuggestionProps) => void;\n  /** A key while the suggestion is active; `true` when the menu took it. */\n  onKeyDown: (event: KeyboardEvent) => boolean;\n  onExit: () => void;\n}\n\nexport interface SlashCommandsExtensionOptions {\n  /** Whether the composer has any command now (read as the trigger is typed): none, no menu. */\n  hasCommands: () => boolean;\n  callbacks: SlashCommandSuggestionCallbacks | null;\n  /** Runs a picked command over the `/query` it was picked from. */\n  onPick: (pick: { editor: Editor; range: Range; match: SlashCommandMatch }) => void;\n}\n\nexport const SLASH_COMMANDS_PLUGIN_KEY = new PluginKey('athenaComposerSlashCommands');\n\nexport const SlashCommandsExtension = Extension.create<SlashCommandsExtensionOptions>({\n  name: 'athenaComposerSlashCommands',\n\n  addOptions() {\n    return {\n      hasCommands: () => false,\n      callbacks: null,\n      onPick: () => {},\n    };\n  },\n\n  addProseMirrorPlugins() {\n    const { callbacks, hasCommands, onPick } = this.options;\n    const propsOf = (props: {\n      query: string;\n      clientRect?: (() => DOMRect | null) | null;\n      command: (match: SlashCommandMatch) => void;\n    }): SlashCommandSuggestionProps => ({\n      query: props.query,\n      clientRect: props.clientRect ?? null,\n      pick: props.command,\n    });\n\n    return [\n      Suggestion<SlashCommandMatch, SlashCommandMatch>({\n        editor: this.editor,\n        pluginKey: SLASH_COMMANDS_PLUGIN_KEY,\n        char: '/',\n        // Arguments follow a command's name (`/open budget`).\n        allowSpaces: true,\n        // At the start of a line, or after a space: `and/or` and a URL's path are no commands.\n        startOfLine: false,\n        allowedPrefixes: [' ', ' '],\n        allow: () => hasCommands(),\n        items: () => [],\n        command: ({ editor, range, props }) => {\n          onPick({ editor, range, match: props });\n        },\n        render: () => ({\n          onStart: (props) => callbacks?.onStart(propsOf(props)),\n          onUpdate: (props) => callbacks?.onUpdate(propsOf(props)),\n          onKeyDown: ({ event }) => callbacks?.onKeyDown(event) ?? false,\n          onExit: () => callbacks?.onExit(),\n        }),\n      }),\n    ];\n  },\n});\n"],"names":[],"mappings":";;;AAuCO,MAAM,4BAA4B,IAAI,UAAU,6BAA6B;AAE7E,MAAM,yBAAyB,UAAU,OAAsC;AAAA,EACpF,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,aAAa,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,QAAQ,MAAM;AAAA,MAAC;AAAA,IAAA;AAAA,EAEnB;AAAA,EAEA,wBAAwB;AACtB,UAAM,EAAE,WAAW,aAAa,OAAA,IAAW,KAAK;AAChD,UAAM,UAAU,CAAC,WAImB;AAAA,MAClC,OAAO,MAAM;AAAA,MACb,YAAY,MAAM,cAAc;AAAA,MAChC,MAAM,MAAM;AAAA,IAAA;AAGd,WAAO;AAAA,MACL,WAAiD;AAAA,QAC/C,QAAQ,KAAK;AAAA,QACb,WAAW;AAAA,QACX,MAAM;AAAA;AAAA,QAEN,aAAa;AAAA;AAAA,QAEb,aAAa;AAAA,QACb,iBAAiB,CAAC,KAAK,GAAG;AAAA,QAC1B,OAAO,MAAM,YAAA;AAAA,QACb,OAAO,MAAM,CAAA;AAAA,QACb,SAAS,CAAC,EAAE,QAAQ,OAAO,YAAY;AACrC,iBAAO,EAAE,QAAQ,OAAO,OAAO,OAAO;AAAA,QACxC;AAAA,QACA,QAAQ,OAAO;AAAA,UACb,SAAS,CAAC,UAAU,uCAAW,QAAQ,QAAQ,KAAK;AAAA,UACpD,UAAU,CAAC,UAAU,uCAAW,SAAS,QAAQ,KAAK;AAAA,UACtD,WAAW,CAAC,EAAE,MAAA,OAAY,uCAAW,UAAU,WAAU;AAAA,UACzD,QAAQ,MAAM,uCAAW;AAAA,QAAO;AAAA,MAClC,CACD;AAAA,IAAA;AAAA,EAEL;AACF,CAAC;"}

package/dist/chat-ui/composer/slash-commands.cjs

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const MatchScore = {
+  ExactAlias: 0,
+  ExactName: 1,
+  NameWithArgs: 2,
+  AliasPrefix: 3,
+  LabelPrefix: 4,
+  AliasContains: 5,
+  LabelContains: 6,
+  AllWords: 7,
+  /** Nothing typed yet: every command, in the order given. */
+  Any: 8
+};
+const normalized = (text) => text.toLowerCase().trim();
+function hasAllWords({ text, words }) {
+  return words.length > 1 && words.every((word) => text.includes(word));
+}
+function scoreCommand({
+  command,
+  query
+}) {
+  const typed = query.trim();
+  if (typed === "") return { score: MatchScore.Any, args: "" };
+  const lower = normalized(typed);
+  const name = normalized(command.name);
+  const aliases = (command.aliases ?? []).map(normalized);
+  const label = normalized(command.label);
+  if (aliases.includes(lower)) return { score: MatchScore.ExactAlias, args: "" };
+  if (name === lower) return { score: MatchScore.ExactName, args: "" };
+  const word = command.args ? [name, ...aliases].filter((candidate) => candidate !== "" && lower.startsWith(`${candidate} `)).sort((a, b) => b.length - a.length)[0] : void 0;
+  if (word !== void 0) {
+    return { score: MatchScore.NameWithArgs, args: typed.slice(word.length).trim() };
+  }
+  if (aliases.some((alias) => alias.startsWith(lower)) || name.startsWith(lower)) {
+    return { score: MatchScore.AliasPrefix, args: "" };
+  }
+  if (label.startsWith(lower)) return { score: MatchScore.LabelPrefix, args: "" };
+  if (aliases.some((alias) => alias.includes(lower)) || name.includes(lower)) {
+    return { score: MatchScore.AliasContains, args: "" };
+  }
+  if (label.includes(lower)) return { score: MatchScore.LabelContains, args: "" };
+  const words = lower.split(/\s+/).filter(Boolean);
+  if ([label, name, ...aliases].some((text) => hasAllWords({ text, words }))) {
+    return { score: MatchScore.AllWords, args: "" };
+  }
+  return null;
+}
+function matchSlashCommands({
+  commands,
+  query
+}) {
+  if (/^\s/.test(query)) return [];
+  const sections = /* @__PURE__ */ new Map();
+  commands.forEach((command, index) => {
+    const scored = scoreCommand({ command, query });
+    if (scored === null) return;
+    const title = command.group ?? null;
+    const section = sections.get(title) ?? { best: Number.POSITIVE_INFINITY, first: index, scored: [] };
+    section.best = Math.min(section.best, scored.score);
+    section.scored.push({ match: { command, args: scored.args }, score: scored.score, index });
+    sections.set(title, section);
+  });
+  return [...sections.entries()].sort(([, a], [, b]) => a.best - b.best || a.first - b.first).map(([title, section]) => ({
+    title,
+    matches: section.scored.sort((a, b) => a.score - b.score || a.index - b.index).map(({ match }) => match)
+  }));
+}
+function slashCommandRows(sections) {
+  return sections.flatMap((section) => section.matches);
+}
+exports.matchSlashCommands = matchSlashCommands;
+exports.slashCommandRows = slashCommandRows;
+//# sourceMappingURL=slash-commands.cjs.map

package/dist/chat-ui/composer/slash-commands.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.cjs","sources":["../../../src/chat-ui/composer/slash-commands.ts"],"sourcesContent":["/**\n * The composer's `/` commands: what a host gives the composer\n * (`TiptapComposer`'s `slashCommands`, `AthenaChat`'s `composer.slashCommands`)\n * and how what is typed after `/` finds them. Modelled on Olympus's composer\n * commands (`olympus/src/components/textbox/extensions/slash-commands/`): a\n * command matches by its label, name and aliases, and the text typed after its\n * name is the command's arguments.\n */\n\nimport type { ComponentType } from 'react';\n\n/** A command's icon, such as a `lucide-react` icon. */\nexport type ComposerSlashCommandIcon = ComponentType<{ className?: string; 'aria-hidden'?: boolean }>;\n\n/** What a command's `run` gets. */\nexport interface ComposerSlashCommandContext {\n  /**\n   * For a command that takes `args`: what was typed after its name or one of\n   * its aliases, trimmed (`/open budget` gives `budget`). Empty when nothing\n   * was, and always for a command that takes none.\n   */\n  args: string;\n  /** Puts `text` into the draft where the command was typed, as typed (never read as Markdown). */\n  insertText: (text: string) => void;\n}\n\n/** A command the composer's `/` menu offers. */\nexport interface ComposerSlashCommand {\n  /** Unique among the commands given; typed after `/` it finds the command, and so do `aliases`. */\n  name: string;\n  /** The menu row's title. */\n  label: string;\n  /** The line under the title: what the command does. */\n  description: string;\n  /** Other words that find the command (`todo` finding plan mode). */\n  aliases?: readonly string[];\n  /**\n   * What the command takes after its name, as the menu shows it while none is\n   * typed (`a link`). Only a command with `args` stays listed, and runs with\n   * them, once more words follow its name: a message that starts with another\n   * command's word (\"/new hire onboarding…\") lists nothing, so Enter sends it.\n   */\n  args?: string;\n  icon?: ComposerSlashCommandIcon;\n  /** The heading the command lists under; commands of one group list together. */\n  group?: string;\n  /**\n   * Why the command can't run right now (\"Needs a connection…\"): it lists\n   * greyed with this reason under its description, and choosing it does\n   * nothing. `null` or absent: it runs.\n   */\n  disabledReason?: string | null;\n  /**\n   * Runs once the person picks the command (Enter, Tab or a click). The typed\n   * `/name args` is already gone from the draft. A promise that rejects is\n   * reported on the diagnostics bus (`composer.slash_command`); the command\n   * says anything the person should see itself.\n   */\n  run: (context: ComposerSlashCommandContext) => void | Promise<void>;\n}\n\n/** A command the typed query finds, with the arguments typed after its name. */\nexport interface SlashCommandMatch {\n  command: ComposerSlashCommand;\n  args: string;\n}\n\n/** One heading of the open menu (`null`: commands with no group) and its matches, best first. */\nexport interface SlashCommandSection {\n  title: string | null;\n  matches: SlashCommandMatch[];\n}\n\n/** How well a command matches, lower first: as Olympus ranks its commands. */\nconst MatchScore = {\n  ExactAlias: 0,\n  ExactName: 1,\n  NameWithArgs: 2,\n  AliasPrefix: 3,\n  LabelPrefix: 4,\n  AliasContains: 5,\n  LabelContains: 6,\n  AllWords: 7,\n  /** Nothing typed yet: every command, in the order given. */\n  Any: 8,\n} as const;\ntype MatchScore = (typeof MatchScore)[keyof typeof MatchScore];\n\nconst normalized = (text: string): string => text.toLowerCase().trim();\n\n/** Every word of the query somewhere in `text`, for a query of two words or more. */\nfunction hasAllWords({ text, words }: { text: string; words: readonly string[] }): boolean {\n  return words.length > 1 && words.every((word) => text.includes(word));\n}\n\nfunction scoreCommand({\n  command,\n  query,\n}: {\n  command: ComposerSlashCommand;\n  query: string;\n}): { score: MatchScore; args: string } | null {\n  const typed = query.trim();\n  if (typed === '') return { score: MatchScore.Any, args: '' };\n  const lower = normalized(typed);\n  const name = normalized(command.name);\n  const aliases = (command.aliases ?? []).map(normalized);\n  const label = normalized(command.label);\n  if (aliases.includes(lower)) return { score: MatchScore.ExactAlias, args: '' };\n  if (name === lower) return { score: MatchScore.ExactName, args: '' };\n  // A command that takes arguments: its name (or an alias) and then them, by\n  // the longest that fits, so `open docs q3` reads past the alias `open docs`.\n  const word = command.args\n    ? [name, ...aliases]\n        .filter((candidate) => candidate !== '' && lower.startsWith(`${candidate} `))\n        .sort((a, b) => b.length - a.length)[0]\n    : undefined;\n  if (word !== undefined) {\n    return { score: MatchScore.NameWithArgs, args: typed.slice(word.length).trim() };\n  }\n  if (aliases.some((alias) => alias.startsWith(lower)) || name.startsWith(lower)) {\n    return { score: MatchScore.AliasPrefix, args: '' };\n  }\n  if (label.startsWith(lower)) return { score: MatchScore.LabelPrefix, args: '' };\n  if (aliases.some((alias) => alias.includes(lower)) || name.includes(lower)) {\n    return { score: MatchScore.AliasContains, args: '' };\n  }\n  if (label.includes(lower)) return { score: MatchScore.LabelContains, args: '' };\n  const words = lower.split(/\\s+/).filter(Boolean);\n  if ([label, name, ...aliases].some((text) => hasAllWords({ text, words }))) {\n    return { score: MatchScore.AllWords, args: '' };\n  }\n  return null;\n}\n\n/** A section's matches while they are ranked: its best score and its first command's place. */\ninterface SectionScores {\n  best: number;\n  first: number;\n  scored: Array<{ match: SlashCommandMatch; score: number; index: number }>;\n}\n\n/**\n * The menu for what is typed after `/` (`query`, the suggestion's text without\n * the slash): the commands it finds, grouped under their `group`, best match\n * first within a group and the group with the best match first, the order the\n * commands were given breaking ties. A query that starts with a space finds\n * nothing (a lone `/` in a sentence is no command). Pure.\n */\nexport function matchSlashCommands({\n  commands,\n  query,\n}: {\n  commands: readonly ComposerSlashCommand[];\n  query: string;\n}): SlashCommandSection[] {\n  if (/^\\s/.test(query)) return [];\n  const sections = new Map<string | null, SectionScores>();\n  commands.forEach((command, index) => {\n    const scored = scoreCommand({ command, query });\n    if (scored === null) return;\n    const title = command.group ?? null;\n    const section = sections.get(title) ?? { best: Number.POSITIVE_INFINITY, first: index, scored: [] };\n    section.best = Math.min(section.best, scored.score);\n    section.scored.push({ match: { command, args: scored.args }, score: scored.score, index });\n    sections.set(title, section);\n  });\n  return [...sections.entries()]\n    .sort(([, a], [, b]) => a.best - b.best || a.first - b.first)\n    .map(([title, section]) => ({\n      title,\n      matches: section.scored\n        .sort((a, b) => a.score - b.score || a.index - b.index)\n        .map(({ match }) => match),\n    }));\n}\n\n/** The menu's rows in the order the keyboard moves through them. */\nexport function slashCommandRows(sections: readonly SlashCommandSection[]): SlashCommandMatch[] {\n  return sections.flatMap((section) => section.matches);\n}\n"],"names":[],"mappings":"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"}

package/dist/chat-ui/composer/slash-commands.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The composer's `/` commands: what a host gives the composer
+ * (`TiptapComposer`'s `slashCommands`, `AthenaChat`'s `composer.slashCommands`)
+ * and how what is typed after `/` finds them. Modelled on Olympus's composer
+ * commands (`olympus/src/components/textbox/extensions/slash-commands/`): a
+ * command matches by its label, name and aliases, and the text typed after its
+ * name is the command's arguments.
+ */
+import type { ComponentType } from 'react';
+/** A command's icon, such as a `lucide-react` icon. */
+export type ComposerSlashCommandIcon = ComponentType<{
+    className?: string;
+    'aria-hidden'?: boolean;
+}>;
+/** What a command's `run` gets. */
+export interface ComposerSlashCommandContext {
+    /**
+     * For a command that takes `args`: what was typed after its name or one of
+     * its aliases, trimmed (`/open budget` gives `budget`). Empty when nothing
+     * was, and always for a command that takes none.
+     */
+    args: string;
+    /** Puts `text` into the draft where the command was typed, as typed (never read as Markdown). */
+    insertText: (text: string) => void;
+}
+/** A command the composer's `/` menu offers. */
+export interface ComposerSlashCommand {
+    /** Unique among the commands given; typed after `/` it finds the command, and so do `aliases`. */
+    name: string;
+    /** The menu row's title. */
+    label: string;
+    /** The line under the title: what the command does. */
+    description: string;
+    /** Other words that find the command (`todo` finding plan mode). */
+    aliases?: readonly string[];
+    /**
+     * What the command takes after its name, as the menu shows it while none is
+     * typed (`a link`). Only a command with `args` stays listed, and runs with
+     * them, once more words follow its name: a message that starts with another
+     * command's word ("/new hire onboarding…") lists nothing, so Enter sends it.
+     */
+    args?: string;
+    icon?: ComposerSlashCommandIcon;
+    /** The heading the command lists under; commands of one group list together. */
+    group?: string;
+    /**
+     * Why the command can't run right now ("Needs a connection…"): it lists
+     * greyed with this reason under its description, and choosing it does
+     * nothing. `null` or absent: it runs.
+     */
+    disabledReason?: string | null;
+    /**
+     * Runs once the person picks the command (Enter, Tab or a click). The typed
+     * `/name args` is already gone from the draft. A promise that rejects is
+     * reported on the diagnostics bus (`composer.slash_command`); the command
+     * says anything the person should see itself.
+     */
+    run: (context: ComposerSlashCommandContext) => void | Promise<void>;
+}
+/** A command the typed query finds, with the arguments typed after its name. */
+export interface SlashCommandMatch {
+    command: ComposerSlashCommand;
+    args: string;
+}
+/** One heading of the open menu (`null`: commands with no group) and its matches, best first. */
+export interface SlashCommandSection {
+    title: string | null;
+    matches: SlashCommandMatch[];
+}
+/**
+ * The menu for what is typed after `/` (`query`, the suggestion's text without
+ * the slash): the commands it finds, grouped under their `group`, best match
+ * first within a group and the group with the best match first, the order the
+ * commands were given breaking ties. A query that starts with a space finds
+ * nothing (a lone `/` in a sentence is no command). Pure.
+ */
+export declare function matchSlashCommands({ commands, query, }: {
+    commands: readonly ComposerSlashCommand[];
+    query: string;
+}): SlashCommandSection[];
+/** The menu's rows in the order the keyboard moves through them. */
+export declare function slashCommandRows(sections: readonly SlashCommandSection[]): SlashCommandMatch[];

package/dist/chat-ui/composer/slash-commands.js

@@ -0,0 +1,74 @@
+const MatchScore = {
+  ExactAlias: 0,
+  ExactName: 1,
+  NameWithArgs: 2,
+  AliasPrefix: 3,
+  LabelPrefix: 4,
+  AliasContains: 5,
+  LabelContains: 6,
+  AllWords: 7,
+  /** Nothing typed yet: every command, in the order given. */
+  Any: 8
+};
+const normalized = (text) => text.toLowerCase().trim();
+function hasAllWords({ text, words }) {
+  return words.length > 1 && words.every((word) => text.includes(word));
+}
+function scoreCommand({
+  command,
+  query
+}) {
+  const typed = query.trim();
+  if (typed === "") return { score: MatchScore.Any, args: "" };
+  const lower = normalized(typed);
+  const name = normalized(command.name);
+  const aliases = (command.aliases ?? []).map(normalized);
+  const label = normalized(command.label);
+  if (aliases.includes(lower)) return { score: MatchScore.ExactAlias, args: "" };
+  if (name === lower) return { score: MatchScore.ExactName, args: "" };
+  const word = command.args ? [name, ...aliases].filter((candidate) => candidate !== "" && lower.startsWith(`${candidate} `)).sort((a, b) => b.length - a.length)[0] : void 0;
+  if (word !== void 0) {
+    return { score: MatchScore.NameWithArgs, args: typed.slice(word.length).trim() };
+  }
+  if (aliases.some((alias) => alias.startsWith(lower)) || name.startsWith(lower)) {
+    return { score: MatchScore.AliasPrefix, args: "" };
+  }
+  if (label.startsWith(lower)) return { score: MatchScore.LabelPrefix, args: "" };
+  if (aliases.some((alias) => alias.includes(lower)) || name.includes(lower)) {
+    return { score: MatchScore.AliasContains, args: "" };
+  }
+  if (label.includes(lower)) return { score: MatchScore.LabelContains, args: "" };
+  const words = lower.split(/\s+/).filter(Boolean);
+  if ([label, name, ...aliases].some((text) => hasAllWords({ text, words }))) {
+    return { score: MatchScore.AllWords, args: "" };
+  }
+  return null;
+}
+function matchSlashCommands({
+  commands,
+  query
+}) {
+  if (/^\s/.test(query)) return [];
+  const sections = /* @__PURE__ */ new Map();
+  commands.forEach((command, index) => {
+    const scored = scoreCommand({ command, query });
+    if (scored === null) return;
+    const title = command.group ?? null;
+    const section = sections.get(title) ?? { best: Number.POSITIVE_INFINITY, first: index, scored: [] };
+    section.best = Math.min(section.best, scored.score);
+    section.scored.push({ match: { command, args: scored.args }, score: scored.score, index });
+    sections.set(title, section);
+  });
+  return [...sections.entries()].sort(([, a], [, b]) => a.best - b.best || a.first - b.first).map(([title, section]) => ({
+    title,
+    matches: section.scored.sort((a, b) => a.score - b.score || a.index - b.index).map(({ match }) => match)
+  }));
+}
+function slashCommandRows(sections) {
+  return sections.flatMap((section) => section.matches);
+}
+export {
+  matchSlashCommands,
+  slashCommandRows
+};
+//# sourceMappingURL=slash-commands.js.map

package/dist/chat-ui/composer/slash-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.js","sources":["../../../src/chat-ui/composer/slash-commands.ts"],"sourcesContent":["/**\n * The composer's `/` commands: what a host gives the composer\n * (`TiptapComposer`'s `slashCommands`, `AthenaChat`'s `composer.slashCommands`)\n * and how what is typed after `/` finds them. Modelled on Olympus's composer\n * commands (`olympus/src/components/textbox/extensions/slash-commands/`): a\n * command matches by its label, name and aliases, and the text typed after its\n * name is the command's arguments.\n */\n\nimport type { ComponentType } from 'react';\n\n/** A command's icon, such as a `lucide-react` icon. */\nexport type ComposerSlashCommandIcon = ComponentType<{ className?: string; 'aria-hidden'?: boolean }>;\n\n/** What a command's `run` gets. */\nexport interface ComposerSlashCommandContext {\n  /**\n   * For a command that takes `args`: what was typed after its name or one of\n   * its aliases, trimmed (`/open budget` gives `budget`). Empty when nothing\n   * was, and always for a command that takes none.\n   */\n  args: string;\n  /** Puts `text` into the draft where the command was typed, as typed (never read as Markdown). */\n  insertText: (text: string) => void;\n}\n\n/** A command the composer's `/` menu offers. */\nexport interface ComposerSlashCommand {\n  /** Unique among the commands given; typed after `/` it finds the command, and so do `aliases`. */\n  name: string;\n  /** The menu row's title. */\n  label: string;\n  /** The line under the title: what the command does. */\n  description: string;\n  /** Other words that find the command (`todo` finding plan mode). */\n  aliases?: readonly string[];\n  /**\n   * What the command takes after its name, as the menu shows it while none is\n   * typed (`a link`). Only a command with `args` stays listed, and runs with\n   * them, once more words follow its name: a message that starts with another\n   * command's word (\"/new hire onboarding…\") lists nothing, so Enter sends it.\n   */\n  args?: string;\n  icon?: ComposerSlashCommandIcon;\n  /** The heading the command lists under; commands of one group list together. */\n  group?: string;\n  /**\n   * Why the command can't run right now (\"Needs a connection…\"): it lists\n   * greyed with this reason under its description, and choosing it does\n   * nothing. `null` or absent: it runs.\n   */\n  disabledReason?: string | null;\n  /**\n   * Runs once the person picks the command (Enter, Tab or a click). The typed\n   * `/name args` is already gone from the draft. A promise that rejects is\n   * reported on the diagnostics bus (`composer.slash_command`); the command\n   * says anything the person should see itself.\n   */\n  run: (context: ComposerSlashCommandContext) => void | Promise<void>;\n}\n\n/** A command the typed query finds, with the arguments typed after its name. */\nexport interface SlashCommandMatch {\n  command: ComposerSlashCommand;\n  args: string;\n}\n\n/** One heading of the open menu (`null`: commands with no group) and its matches, best first. */\nexport interface SlashCommandSection {\n  title: string | null;\n  matches: SlashCommandMatch[];\n}\n\n/** How well a command matches, lower first: as Olympus ranks its commands. */\nconst MatchScore = {\n  ExactAlias: 0,\n  ExactName: 1,\n  NameWithArgs: 2,\n  AliasPrefix: 3,\n  LabelPrefix: 4,\n  AliasContains: 5,\n  LabelContains: 6,\n  AllWords: 7,\n  /** Nothing typed yet: every command, in the order given. */\n  Any: 8,\n} as const;\ntype MatchScore = (typeof MatchScore)[keyof typeof MatchScore];\n\nconst normalized = (text: string): string => text.toLowerCase().trim();\n\n/** Every word of the query somewhere in `text`, for a query of two words or more. */\nfunction hasAllWords({ text, words }: { text: string; words: readonly string[] }): boolean {\n  return words.length > 1 && words.every((word) => text.includes(word));\n}\n\nfunction scoreCommand({\n  command,\n  query,\n}: {\n  command: ComposerSlashCommand;\n  query: string;\n}): { score: MatchScore; args: string } | null {\n  const typed = query.trim();\n  if (typed === '') return { score: MatchScore.Any, args: '' };\n  const lower = normalized(typed);\n  const name = normalized(command.name);\n  const aliases = (command.aliases ?? []).map(normalized);\n  const label = normalized(command.label);\n  if (aliases.includes(lower)) return { score: MatchScore.ExactAlias, args: '' };\n  if (name === lower) return { score: MatchScore.ExactName, args: '' };\n  // A command that takes arguments: its name (or an alias) and then them, by\n  // the longest that fits, so `open docs q3` reads past the alias `open docs`.\n  const word = command.args\n    ? [name, ...aliases]\n        .filter((candidate) => candidate !== '' && lower.startsWith(`${candidate} `))\n        .sort((a, b) => b.length - a.length)[0]\n    : undefined;\n  if (word !== undefined) {\n    return { score: MatchScore.NameWithArgs, args: typed.slice(word.length).trim() };\n  }\n  if (aliases.some((alias) => alias.startsWith(lower)) || name.startsWith(lower)) {\n    return { score: MatchScore.AliasPrefix, args: '' };\n  }\n  if (label.startsWith(lower)) return { score: MatchScore.LabelPrefix, args: '' };\n  if (aliases.some((alias) => alias.includes(lower)) || name.includes(lower)) {\n    return { score: MatchScore.AliasContains, args: '' };\n  }\n  if (label.includes(lower)) return { score: MatchScore.LabelContains, args: '' };\n  const words = lower.split(/\\s+/).filter(Boolean);\n  if ([label, name, ...aliases].some((text) => hasAllWords({ text, words }))) {\n    return { score: MatchScore.AllWords, args: '' };\n  }\n  return null;\n}\n\n/** A section's matches while they are ranked: its best score and its first command's place. */\ninterface SectionScores {\n  best: number;\n  first: number;\n  scored: Array<{ match: SlashCommandMatch; score: number; index: number }>;\n}\n\n/**\n * The menu for what is typed after `/` (`query`, the suggestion's text without\n * the slash): the commands it finds, grouped under their `group`, best match\n * first within a group and the group with the best match first, the order the\n * commands were given breaking ties. A query that starts with a space finds\n * nothing (a lone `/` in a sentence is no command). Pure.\n */\nexport function matchSlashCommands({\n  commands,\n  query,\n}: {\n  commands: readonly ComposerSlashCommand[];\n  query: string;\n}): SlashCommandSection[] {\n  if (/^\\s/.test(query)) return [];\n  const sections = new Map<string | null, SectionScores>();\n  commands.forEach((command, index) => {\n    const scored = scoreCommand({ command, query });\n    if (scored === null) return;\n    const title = command.group ?? null;\n    const section = sections.get(title) ?? { best: Number.POSITIVE_INFINITY, first: index, scored: [] };\n    section.best = Math.min(section.best, scored.score);\n    section.scored.push({ match: { command, args: scored.args }, score: scored.score, index });\n    sections.set(title, section);\n  });\n  return [...sections.entries()]\n    .sort(([, a], [, b]) => a.best - b.best || a.first - b.first)\n    .map(([title, section]) => ({\n      title,\n      matches: section.scored\n        .sort((a, b) => a.score - b.score || a.index - b.index)\n        .map(({ match }) => match),\n    }));\n}\n\n/** The menu's rows in the order the keyboard moves through them. */\nexport function slashCommandRows(sections: readonly SlashCommandSection[]): SlashCommandMatch[] {\n  return sections.flatMap((section) => section.matches);\n}\n"],"names":[],"mappings":"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"}