@tutti-os/ui-rich-text 0.0.12 → 0.0.13

package/README.md

@@ -47,100 +47,95 @@ Current refactor plan:
 4. Keep domain-specific reference protocols in their owning packages and only
    promote the generic rich-text seam here when it is truly host-agnostic.
 
-## Mention protocol draft
+## Mention Protocol
 
-The first stable plugin contract in this package is the `@` mention protocol.
+The stable `@` mention storage protocol is provider-agnostic:
+
+```md
+[@Label](mention://provider-id/entity-id?workspaceId=ws_1)
+```
 
 Boundary split:
 
 - the editor core owns trigger detection, selection state, keyboard handling,
   insertion lifecycle, and storage shape
-- the host plugin owns query behavior, suggestion copy, insert mapping, and
-  reverse resolution
+- the host trigger provider owns query behavior, suggestion copy, insert
+  mapping, and reverse resolution
 
 Stable stored attrs:
 
 ```ts
-type RichTextMentionAttrs = {
+interface RichTextMentionAttrs {
   trigger: "@";
-  plugin: string;
+  providerId: string;
   entityId: string;
   label: string;
-  href?: string;
-  kind?: string;
-  version?: string;
-  meta?: Readonly<Record<string, string>>;
-};
+  scope?: Readonly<Record<string, string>>;
+  presentation?: RichTextMentionPresentation;
+}
 ```
 
 Why this shape:
 
-- `plugin` identifies which host capability owns the token
+- `providerId` identifies which host capability owns the token
 - `entityId` is the durable identity and must not depend on visible copy
 - `label` is the last rendered fallback text so readonly and indexing can still
   work without a roundtrip
-- `href`, `kind`, `version`, and `meta` are optional extension points for host
-  routing and compatibility
+- `scope` holds short identity fields needed to locate the entity
+- `presentation` is editor-only display data and is not serialized to Markdown
 
-Plugin contract:
+Trigger provider contract:
 
 ```ts
-interface RichTextMentionPlugin<TItem = unknown, TResolved = unknown> {
+interface RichTextTriggerProvider<TItem = unknown> {
   id: string;
-  trigger?: "@";
+  trigger: RichTextTrigger;
+  boundary?: RichTextTriggerBoundary;
   query: (
-    input: RichTextMentionQueryInput
+    input: RichTextTriggerQueryInput
   ) => Promise<readonly TItem[]> | readonly TItem[];
   getItemKey: (item: TItem) => string;
   getItemLabel: (item: TItem) => string;
   getItemSubtitle?: (item: TItem) => string | null | undefined;
+  getItemThumbnailUrl?: (
+    item: TItem
+  ) => string | null | undefined | Promise<string | null | undefined>;
   getItemKeywords?: (item: TItem) => readonly string[] | undefined;
-  toMention: (item: TItem) => RichTextMentionInsert;
-  renderText?: (attrs: RichTextMentionAttrs) => string;
+  toInsertResult: (item: TItem) => RichTextTriggerInsertResult;
   resolveMention?: (
-    input: RichTextMentionResolveInput
-  ) =>
-    | Promise<RichTextResolvedMention<TResolved>>
-    | RichTextResolvedMention<TResolved>;
+    identity: RichTextMentionIdentity
+  ) => Promise<RichTextMentionResolved | null> | RichTextMentionResolved | null;
 }
 ```
 
 Interpretation:
 
-- `query` decides what `@` can mention
+- `query` decides what a trigger can mention
 - `getItemLabel` and `getItemSubtitle` decide the suggestion copy
-- `toMention` maps a chosen item into the stored attrs shape
-- `renderText` lets the host override readonly text such as `@Alice` vs
-  `@Alice Chen`
-- `resolveMention` maps stored attrs into a fixed display state plus an optional
-  resolved entity payload
+- `toInsertResult` maps a chosen item into a mention, markdown-link, or text
+  insertion
+- `resolveMention` restores editor-only label or presentation data from the
+  stored mention identity
 
-Display-state protocol:
+Mention data:
 
 ```ts
-type RichTextMentionRenderState = "active" | "missing" | "disabled" | "loading";
+interface RichTextMentionInsert {
+  entityId: string;
+  label: string;
+  scope?: Readonly<Record<string, string>>;
+  presentation?: RichTextMentionPresentation;
+}
 
-type RichTextResolvedMention<TResolved = unknown> = {
-  state: RichTextMentionRenderState;
+interface RichTextMentionResolved {
   label?: string;
-  tooltip?: string;
-  href?: string;
-  entity?: TResolved;
-};
+  presentation?: RichTextMentionPresentation;
+}
 ```
 
-Interpretation:
-
-- `active` means normal styling and normal interaction
-- `missing` means the original resource no longer exists and should render in a
-  muted non-interactive style
-- `disabled` means the resource still exists but the current host should not
-  allow normal interaction, for example because of permissions or product rules
-- `loading` is a temporary host-controlled resolution state
-
-This package intentionally keeps the public status model visual and generic.
-Business-specific reasons such as deleted, archived, forbidden, or offline stay
-inside the host plugin and collapse into one of the fixed render states above.
+Markdown serialization includes only `providerId`, `entityId`, `label`, and
+short `scope` fields. It does not serialize `presentation`, `href`, `kind`,
+`version`, or arbitrary metadata.
 
 Helpers now exported:
 
@@ -155,14 +150,12 @@ Helpers now exported:
 
 Runtime surfaces now exported:
 
-- `RichTextAtTextarea`
+- `RichTextTriggerTextarea`
 - `RichTextMentionReadonly`
 
 Current runtime behavior:
 
-- the registry aggregates multiple `@` plugins in declaration order
-- query results are flattened into a shared result shape with prebuilt mention
-  attrs
-- resolve falls back to `missing` when the plugin no longer exists
-- readonly rendering maps the resolved state into one fixed visual shape family
-  with overridable labels, tooltips, and click handling
+- the registry aggregates multiple trigger providers in declaration order
+- query results are flattened into a shared result shape
+- mention hydration uses `resolveMention` when the owning trigger provider is
+  available and keeps the label-only fallback when it is not

package/dist/at-panel/index.css

@@ -0,0 +1,190 @@
+/* src/at-panel/mentionPalette.css */
+.rich-text-at-mention-palette-scroll-region {
+  scrollbar-width: none !important;
+  -ms-overflow-style: none !important;
+  scrollbar-gutter: auto;
+}
+.rich-text-at-mention-palette-scroll-region::-webkit-scrollbar {
+  display: none !important;
+  width: 0 !important;
+  height: 0 !important;
+}
+.rich-text-at-mention-palette-scrollbar {
+  position: absolute;
+  top: 4px;
+  right: 4px;
+  bottom: 4px;
+  width: 4px;
+  cursor: pointer;
+  opacity: 0;
+  pointer-events: auto;
+  transition: opacity 160ms ease-in-out;
+}
+.rich-text-at-mention-palette-scrollbar-thumb {
+  width: 4px;
+  min-height: 24px;
+  border-radius: 999px;
+  background: var(--transparency-block);
+  cursor: grab;
+  transition: background-color 160ms ease-in-out;
+  will-change: transform;
+}
+.rich-text-at-mention-palette-scrollbar:hover .rich-text-at-mention-palette-scrollbar-thumb {
+  background: var(--transparency-hover);
+}
+.rich-text-at-mention-palette-scrollbar[data-dragging=true] {
+  opacity: 1;
+}
+.rich-text-at-mention-palette-scrollbar[data-dragging=true] .rich-text-at-mention-palette-scrollbar-thumb {
+  background: var(--transparency-hover);
+  cursor: grabbing;
+}
+.rich-text-at-mention-palette {
+  container-type: inline-size;
+}
+.tsh-underline-tabs.rich-text-at-mention-palette-tabs {
+  height: 41px;
+  padding: 8px 16px 0;
+}
+.rich-text-at-mention-palette-header {
+  padding: 8px 0 0;
+}
+.rich-text-at-mention-palette-footer {
+  min-height: 36px;
+  border-top: 1px solid var(--line-2, var(--tutti-line-2));
+  background: var(--background-fronted, var(--background-panel));
+}
+.rich-text-at-mention-palette-hint {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  width: 100%;
+  height: 36px;
+  padding: 0 16px 1px;
+  color: var(--agent-gui-text-secondary, var(--text-secondary));
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 20px;
+  pointer-events: auto;
+}
+.rich-text-at-mention-palette-hint-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  white-space: nowrap;
+}
+.rich-text-at-mention-palette-hint-button,
+.rich-text-at-mention-palette-shortcut-button {
+  appearance: none;
+  border: 0;
+  font: inherit;
+  cursor: pointer;
+}
+.rich-text-at-mention-palette-hint-button {
+  padding: 0;
+  background: transparent;
+  color: inherit;
+}
+.rich-text-at-mention-palette-shortcut {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 20px;
+  min-width: 20px;
+  border-radius: 4px;
+  background: color-mix(in srgb, var(--transparency-block) 72%, transparent);
+  color: var(--agent-gui-text-secondary, var(--text-secondary));
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 1;
+  padding: 4px 6px;
+}
+.rich-text-at-mention-palette-hint-button:hover .rich-text-at-mention-palette-shortcut,
+.rich-text-at-mention-palette-hint-button:focus-visible .rich-text-at-mention-palette-shortcut,
+.rich-text-at-mention-palette-shortcut-button:hover,
+.rich-text-at-mention-palette-shortcut-button:focus-visible {
+  background: var(--transparency-block);
+}
+.rich-text-at-mention-palette-hint-button:focus-visible,
+.rich-text-at-mention-palette-shortcut-button:focus-visible {
+  outline: 2px solid var(--line-1);
+  outline-offset: 2px;
+}
+.rich-text-at-mention-palette-shortcut--arrow {
+  width: 20px;
+  min-width: 20px;
+  font-size: 13px;
+  line-height: 1;
+  padding: 0;
+}
+.rich-text-at-mention-palette-shortcut-group {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+}
+.rich-text-at-mention-palette-hint-separator {
+  color: var(--line-2, var(--tutti-line-2));
+}
+.rich-text-at-mention-palette:hover .rich-text-at-mention-palette-scrollbar[data-scrollable=true] {
+  opacity: 1;
+}
+.rich-text-at-mention-palette {
+  --agent-mention-file-icon-size: 16px;
+}
+.rich-text-at-mention-file-thumb {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: var(--agent-mention-file-icon-size, 16px);
+  height: var(--agent-mention-file-icon-size, 16px);
+  flex: 0 0 var(--agent-mention-file-icon-size, 16px);
+  overflow: hidden;
+  border-radius: 4px;
+  background-color: var(--bg-block, var(--block));
+  vertical-align: middle;
+}
+.rich-text-at-mention-file-thumb img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+.rich-text-at-mention-file-icon {
+  width: var(--agent-mention-file-icon-size, 16px);
+  height: var(--agent-mention-file-icon-size, 16px);
+  flex: 0 0 var(--agent-mention-file-icon-size, 16px);
+  background-color: var(--folder);
+  border-radius: 4px;
+}
+.rich-text-at-mention-kind-icon {
+  display: block;
+  width: 16px;
+  height: 16px;
+  flex: 0 0 16px;
+  background-color: currentColor;
+  border-radius: 22.5%;
+}
+.rich-text-at-mention-avatar-img--user-placeholder {
+  background-color: var(--muted);
+}
+[data-workspace-app-icon=true] {
+  display: inline-grid;
+  min-width: 0;
+  min-height: 0;
+  place-items: center;
+  overflow: hidden;
+  border-radius: 22.5%;
+  background: var(--workspace-app-icon-bg, transparent);
+}
+[data-workspace-app-icon=true] > img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  object-position: center;
+}
+[data-workspace-app-icon=true] > .rich-text-at-mention-kind-icon {
+  display: block;
+}
+/*# sourceMappingURL=index.css.map */

package/dist/at-panel/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/at-panel/mentionPalette.css"],"sourcesContent":[".rich-text-at-mention-palette-scroll-region {\n  scrollbar-width: none !important;\n  -ms-overflow-style: none !important;\n  scrollbar-gutter: auto;\n}\n\n.rich-text-at-mention-palette-scroll-region::-webkit-scrollbar {\n  display: none !important;\n  width: 0 !important;\n  height: 0 !important;\n}\n\n.rich-text-at-mention-palette-scrollbar {\n  position: absolute;\n  top: 4px;\n  right: 4px;\n  bottom: 4px;\n  width: 4px;\n  cursor: pointer;\n  opacity: 0;\n  pointer-events: auto;\n  transition: opacity 160ms ease-in-out;\n}\n\n.rich-text-at-mention-palette-scrollbar-thumb {\n  width: 4px;\n  min-height: 24px;\n  border-radius: 999px;\n  background: var(--transparency-block);\n  cursor: grab;\n  transition: background-color 160ms ease-in-out;\n  will-change: transform;\n}\n\n.rich-text-at-mention-palette-scrollbar:hover\n  .rich-text-at-mention-palette-scrollbar-thumb {\n  background: var(--transparency-hover);\n}\n\n.rich-text-at-mention-palette-scrollbar[data-dragging=\"true\"] {\n  opacity: 1;\n}\n\n.rich-text-at-mention-palette-scrollbar[data-dragging=\"true\"]\n  .rich-text-at-mention-palette-scrollbar-thumb {\n  background: var(--transparency-hover);\n  cursor: grabbing;\n}\n\n.rich-text-at-mention-palette {\n  container-type: inline-size;\n}\n\n.tsh-underline-tabs.rich-text-at-mention-palette-tabs {\n  height: 41px;\n  padding: 8px 16px 0;\n}\n\n.rich-text-at-mention-palette-header {\n  padding: 8px 0 0;\n}\n\n.rich-text-at-mention-palette-footer {\n  min-height: 36px;\n  border-top: 1px solid var(--line-2, var(--tutti-line-2));\n  background: var(--background-fronted, var(--background-panel));\n}\n\n.rich-text-at-mention-palette-hint {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  width: 100%;\n  height: 36px;\n  padding: 0 16px 1px;\n  color: var(--agent-gui-text-secondary, var(--text-secondary));\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 20px;\n  pointer-events: auto;\n}\n\n.rich-text-at-mention-palette-hint-item {\n  display: inline-flex;\n  align-items: center;\n  gap: 5px;\n  white-space: nowrap;\n}\n\n.rich-text-at-mention-palette-hint-button,\n.rich-text-at-mention-palette-shortcut-button {\n  appearance: none;\n  border: 0;\n  font: inherit;\n  cursor: pointer;\n}\n\n.rich-text-at-mention-palette-hint-button {\n  padding: 0;\n  background: transparent;\n  color: inherit;\n}\n\n.rich-text-at-mention-palette-shortcut {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  height: 20px;\n  min-width: 20px;\n  border-radius: 4px;\n  background: color-mix(in srgb, var(--transparency-block) 72%, transparent);\n  color: var(--agent-gui-text-secondary, var(--text-secondary));\n  font-size: 13px;\n  font-weight: 600;\n  line-height: 1;\n  padding: 4px 6px;\n}\n\n.rich-text-at-mention-palette-hint-button:hover\n  .rich-text-at-mention-palette-shortcut,\n.rich-text-at-mention-palette-hint-button:focus-visible\n  .rich-text-at-mention-palette-shortcut,\n.rich-text-at-mention-palette-shortcut-button:hover,\n.rich-text-at-mention-palette-shortcut-button:focus-visible {\n  background: var(--transparency-block);\n}\n\n.rich-text-at-mention-palette-hint-button:focus-visible,\n.rich-text-at-mention-palette-shortcut-button:focus-visible {\n  outline: 2px solid var(--line-1);\n  outline-offset: 2px;\n}\n\n.rich-text-at-mention-palette-shortcut--arrow {\n  width: 20px;\n  min-width: 20px;\n  font-size: 13px;\n  line-height: 1;\n  padding: 0;\n}\n\n.rich-text-at-mention-palette-shortcut-group {\n  display: inline-flex;\n  align-items: center;\n  gap: 5px;\n}\n\n.rich-text-at-mention-palette-hint-separator {\n  color: var(--line-2, var(--tutti-line-2));\n}\n\n.rich-text-at-mention-palette:hover\n  .rich-text-at-mention-palette-scrollbar[data-scrollable=\"true\"] {\n  opacity: 1;\n}\n\n.rich-text-at-mention-palette {\n  --agent-mention-file-icon-size: 16px;\n}\n\n/*\n * Structural styling for the shared MentionRow elements. These mirror the\n * agent composer's rules (in `agentactivity.css`) under package-owned\n * `rich-text-at-mention-*` class names so any consumer (e.g. issue-manager)\n * that does NOT load the agent stylesheet still renders styled rows. The agent\n * keeps passing its own class names via `renderMentionRow(item, classNames)`.\n */\n.rich-text-at-mention-file-thumb {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--agent-mention-file-icon-size, 16px);\n  height: var(--agent-mention-file-icon-size, 16px);\n  flex: 0 0 var(--agent-mention-file-icon-size, 16px);\n  overflow: hidden;\n  border-radius: 4px;\n  background-color: var(--bg-block, var(--block));\n  vertical-align: middle;\n}\n\n.rich-text-at-mention-file-thumb img {\n  display: block;\n  width: 100%;\n  height: 100%;\n  object-fit: cover;\n}\n\n/*\n * NOTE: the masked file kind-icon glyph and the fallback app glyph need raw SVG\n * mask assets. Those cannot live in this package (the `check-ui-boundaries`\n * gate restricts raw .svg assets to `packages/ui/system/src/icons/`), so only\n * the structural box (size/layout) is owned here. The agent composer supplies\n * its own masked glyph rules via `agentactivity.css` + its own class names. The\n * issue-manager file glyph + app fallback glyph are completed in Phases 3-4.\n */\n.rich-text-at-mention-file-icon {\n  width: var(--agent-mention-file-icon-size, 16px);\n  height: var(--agent-mention-file-icon-size, 16px);\n  flex: 0 0 var(--agent-mention-file-icon-size, 16px);\n  background-color: var(--folder);\n  border-radius: 4px;\n}\n\n/* Fallback app glyph box (shown when a workspace-app mention has no icon URL). */\n.rich-text-at-mention-kind-icon {\n  display: block;\n  width: 16px;\n  height: 16px;\n  flex: 0 0 16px;\n  background-color: currentColor;\n  border-radius: 22.5%;\n}\n\n/* Session user-avatar placeholder background (no avatar URL). */\n.rich-text-at-mention-avatar-img--user-placeholder {\n  background-color: var(--muted);\n}\n\n/*\n * Workspace-app icon container. Data-attribute based (matches the agent's\n * global rule) so the rounded app icon renders for any consumer of the shared\n * row, including surfaces that do not load `agentactivity.css`.\n */\n[data-workspace-app-icon=\"true\"] {\n  display: inline-grid;\n  min-width: 0;\n  min-height: 0;\n  place-items: center;\n  overflow: hidden;\n  border-radius: 22.5%;\n  background: var(--workspace-app-icon-bg, transparent);\n}\n\n[data-workspace-app-icon=\"true\"] > img {\n  display: block;\n  width: 100%;\n  height: 100%;\n  object-fit: cover;\n  object-position: center;\n}\n\n[data-workspace-app-icon=\"true\"] > .rich-text-at-mention-kind-icon {\n  display: block;\n}\n"],"mappings":";AAAA,CAAC;AACC,mBAAiB;AACjB,sBAAoB;AACpB,oBAAkB;AACpB;AAEA,CANC,0CAM0C;AACzC,WAAS;AACT,SAAO;AACP,UAAQ;AACV;AAEA,CAAC;AACC,YAAU;AACV,OAAK;AACL,SAAO;AACP,UAAQ;AACR,SAAO;AACP,UAAQ;AACR,WAAS;AACT,kBAAgB;AAChB,cAAY,QAAQ,MAAM;AAC5B;AAEA,CAAC;AACC,SAAO;AACP,cAAY;AACZ,iBAAe;AACf,cAAY,IAAI;AAChB,UAAQ;AACR,cAAY,iBAAiB,MAAM;AACnC,eAAa;AACf;AAEA,CAtBC,sCAsBsC,OACrC,CAXD;AAYC,cAAY,IAAI;AAClB;AAEA,CA3BC,sCA2BsC,CAAC;AACtC,WAAS;AACX;AAEA,CA/BC,sCA+BsC,CAAC,oBACtC,CApBD;AAqBC,cAAY,IAAI;AAChB,UAAQ;AACV;AAEA,CAAC;AACC,kBAAgB;AAClB;AAEA,CAAC,kBAAkB,CAAC;AAClB,UAAQ;AACR,WAAS,IAAI,KAAK;AACpB;AAEA,CAAC;AACC,WAAS,IAAI,EAAE;AACjB;AAEA,CAAC;AACC,cAAY;AACZ,cAAY,IAAI,MAAM,IAAI,QAAQ,EAAE,IAAI;AACxC,cAAY,IAAI,oBAAoB,EAAE,IAAI;AAC5C;AAEA,CAAC;AACC,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,OAAK;AACL,SAAO;AACP,UAAQ;AACR,WAAS,EAAE,KAAK;AAChB,SAAO,IAAI,0BAA0B,EAAE,IAAI;AAC3C,aAAW;AACX,eAAa;AACb,eAAa;AACb,kBAAgB;AAClB;AAEA,CAAC;AACC,WAAS;AACT,eAAa;AACb,OAAK;AACL,eAAa;AACf;AAEA,CAAC;AACD,CAAC;AACC,cAAY;AACZ,UAAQ;AACR,QAAM;AACN,UAAQ;AACV;AAEA,CARC;AASC,WAAS;AACT,cAAY;AACZ,SAAO;AACT;AAEA,CAAC;AACC,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,UAAQ;AACR,aAAW;AACX,iBAAe;AACf,cAAY,UAAU,GAAG,IAAI,EAAE,IAAI,sBAAsB,GAAG,EAAE;AAC9D,SAAO,IAAI,0BAA0B,EAAE,IAAI;AAC3C,aAAW;AACX,eAAa;AACb,eAAa;AACb,WAAS,IAAI;AACf;AAEA,CA7BC,wCA6BwC,OACvC,CAhBD;AAiBD,CA/BC,wCA+BwC,eACvC,CAlBD;AAmBD,CAhCC,4CAgC4C;AAC7C,CAjCC,4CAiC4C;AAC3C,cAAY,IAAI;AAClB;AAEA,CAtCC,wCAsCwC;AACzC,CAtCC,4CAsC4C;AAC3C,WAAS,IAAI,MAAM,IAAI;AACvB,kBAAgB;AAClB;AAEA,CAAC;AACC,SAAO;AACP,aAAW;AACX,aAAW;AACX,eAAa;AACb,WAAS;AACX;AAEA,CAAC;AACC,WAAS;AACT,eAAa;AACb,OAAK;AACP;AAEA,CAAC;AACC,SAAO,IAAI,QAAQ,EAAE,IAAI;AAC3B;AAEA,CAvGC,4BAuG4B,OAC3B,CA7ID,sCA6IwC,CAAC;AACxC,WAAS;AACX;AAEA,CA5GC;AA6GC,kCAAgC;AAClC;AASA,CAAC;AACC,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,SAAO,IAAI,8BAA8B,EAAE;AAC3C,UAAQ,IAAI,8BAA8B,EAAE;AAC5C,QAAM,EAAE,EAAE,IAAI,8BAA8B,EAAE;AAC9C,YAAU;AACV,iBAAe;AACf,oBAAkB,IAAI,UAAU,EAAE,IAAI;AACtC,kBAAgB;AAClB;AAEA,CAbC,gCAagC;AAC/B,WAAS;AACT,SAAO;AACP,UAAQ;AACR,cAAY;AACd;AAUA,CAAC;AACC,SAAO,IAAI,8BAA8B,EAAE;AAC3C,UAAQ,IAAI,8BAA8B,EAAE;AAC5C,QAAM,EAAE,EAAE,IAAI,8BAA8B,EAAE;AAC9C,oBAAkB,IAAI;AACtB,iBAAe;AACjB;AAGA,CAAC;AACC,WAAS;AACT,SAAO;AACP,UAAQ;AACR,QAAM,EAAE,EAAE;AACV,oBAAkB;AAClB,iBAAe;AACjB;AAGA,CAAC;AACC,oBAAkB,IAAI;AACxB;AAOA,CAAC;AACC,WAAS;AACT,aAAW;AACX,cAAY;AACZ,eAAa;AACb,YAAU;AACV,iBAAe;AACf,cAAY,IAAI,uBAAuB,EAAE;AAC3C;AAEA,CAAC,8BAAgC,EAAE;AACjC,WAAS;AACT,SAAO;AACP,UAAQ;AACR,cAAY;AACZ,mBAAiB;AACnB;AAEA,CAAC,8BAAgC,EAAE,CArClC;AAsCC,WAAS;AACX;","names":[]}

package/dist/at-panel/index.d.ts

@@ -0,0 +1,63 @@
+import { MentionPaletteProps, MentionRowItem } from './model.js';
+export { DEFAULT_RICH_TEXT_AT_PANEL_PAGE_SIZE, MentionFileVisualKind, MentionFileVisualKindInput, MentionPaletteCategory, MentionPaletteEntry, MentionPaletteFilterId, MentionPaletteGroup, MentionPaletteGroupId, MentionPaletteState, MentionPaletteTheme, MentionRowAppFactoryItem, MentionRowAppItem, MentionRowFileItem, MentionRowIssueItem, MentionRowSessionItem, MentionRowStatusTag, MentionRowStatusTone, MentionRowStatusVariant, RICH_TEXT_AT_ALL_FILTER_ID, RichTextAtFilterId, RichTextAtFilterTab, RichTextAtGroupId, RichTextAtSearchGroup, RichTextTriggerProviderGroup, activityMentionStatusBadgeClassName, activityMentionStatusTone, buildDefaultRichTextTriggerProviderGroups, buildMentionPaletteState, buildRichTextAtFilterTabs, findRichTextTriggerProviderGroup, flattenMentionPaletteEntries, groupRichTextAtMatches, issueMentionStatusBadgeClassName, issueMentionStatusTone, mentionStatusBadgeClassName, normalizeAtPanelQuery, resolveMentionFileThumbnailUrl, resolveMentionFileVisualKind, richTextAtGroupExpandCount } from './model.js';
+import { JSX } from 'react';
+import '../types/index.js';
+import '../mention-CgUcsO8r.js';
+
+declare function MentionPalette<TItem>(props: MentionPaletteProps<TItem>): JSX.Element;
+
+type MentionRowDataAttributeMode = "shared" | "agent";
+
+/**
+ * Structural class-name hooks for the elements a {@link MentionRow} renders that
+ * rely on a stylesheet (file icon/thumb, the app fallback kind-icon, and the
+ * session avatar placeholder modifier). Every key is optional and defaults to a
+ * PACKAGE-OWNED `rich-text-at-mention-*` class whose CSS ships with
+ * `mentionPalette.css`, so any consumer renders styled rows out of the box.
+ *
+ * Surfaces with their own stylesheet (e.g. the agent composer) pass their exact
+ * existing class names here so their rendered DOM stays byte-identical.
+ */
+interface MentionRowClassNames {
+    /** The masked file kind-icon `<span>`. */
+    fileIcon?: string;
+    /** The image-thumbnail wrapper `<span>` (rendered for image files). */
+    fileThumb?: string;
+    /** The fallback app icon glyph rendered when no `iconUrl` is present. */
+    kindIcon?: string;
+    /**
+     * Modifier class added to the session user avatar `<img>` when the user has no
+     * avatar URL and the placeholder asset is shown.
+     */
+    avatarImgUserPlaceholder?: string;
+}
+interface MentionRowRenderOptions {
+    classNames?: MentionRowClassNames;
+    dataAttributeMode?: MentionRowDataAttributeMode;
+}
+/**
+ * Render the inner content of a single `@`-mention palette row from a
+ * fully-resolved {@link MentionRowItem}. The surrounding option button / active
+ * state is provided by the shared `MentionPalette` shell; this renders only the
+ * row body.
+ *
+ * Pass {@link classNames} to override the package-owned structural class hooks
+ * (e.g. so the agent composer keeps emitting its own stylesheet's class names).
+ */
+declare function renderMentionRow(item: MentionRowItem, options?: MentionRowClassNames | MentionRowRenderOptions): React.ReactNode;
+
+interface AtPanelKeyboardActions {
+    moveSelection: (delta: 1 | -1) => void;
+    commitSelection: () => void;
+    close: () => void;
+    cycleFilter?: (delta: 1 | -1) => void;
+}
+interface AtPanelKeyboardEventLike {
+    key: string;
+    shiftKey?: boolean;
+    preventDefault: () => void;
+}
+declare function makeAtPanelKeyDown(actions: AtPanelKeyboardActions): (event: AtPanelKeyboardEventLike) => boolean;
+declare function useAtPanelKeyboard(actions: AtPanelKeyboardActions): (event: AtPanelKeyboardEventLike) => boolean;
+
+export { type AtPanelKeyboardActions, type AtPanelKeyboardEventLike, MentionPalette, MentionPaletteProps, type MentionRowClassNames, type MentionRowDataAttributeMode, MentionRowItem, type MentionRowRenderOptions, makeAtPanelKeyDown, renderMentionRow, useAtPanelKeyboard };