@orangelogic/design-system 3.15.0 → 3.16.0

package/library/components/types.js

@@ -85,7 +85,7 @@ import { default as it } from "./visually-hidden.js";
 import { fontAwesomeIconNames as mt, getAnimationNames as pt, getEasingNames as ft } from "./atoms.js";
 import { c as Ct } from "../chunks/component.styles.CAS3c9pM.js";
 import { g as ut, a as ct, s as gt } from "../chunks/animation-registry.HmpwNuGH.js";
-import { s as At, u as It, Y as St, v as Dt, n as bt, C as ht, m as yt, $ as Ft, a0 as Et, a1 as Pt, a3 as Rt, a2 as Lt, a4 as vt, a5 as Vt, a6 as Bt, a7 as Mt, a8 as Ot, l as wt, Z as kt, w as Gt, _ as _t, x as Nt, y as Ht, z as Ut, k as Xt, a9 as zt, B as Wt, E as Kt, G as qt, H as jt, aa as Yt, j as Qt, J as Zt, K as Jt, h as $t, V as ao, W as eo, ab as to, f as oo, L as ro, M as so, N as xo, P as io, Q as lo, R as mo, ac as po, ad as fo, T as no, U as Co, ae as uo, af as co, e as go, X as To, ag as Ao, ah as Io } from "../chunks/types.Bc8Tgozj.js";
+import { s as At, u as It, Y as St, v as Dt, n as bt, C as ht, m as yt, $ as Ft, a0 as Et, a1 as Pt, a3 as Rt, a2 as Lt, a4 as vt, a5 as Vt, a6 as Bt, a7 as Mt, a8 as Ot, l as wt, Z as kt, w as Gt, _ as _t, x as Nt, y as Ht, z as Ut, k as Xt, a9 as zt, B as Wt, E as Kt, G as qt, H as jt, aa as Yt, j as Qt, J as Zt, K as Jt, h as $t, V as ao, W as eo, ab as to, f as oo, L as ro, M as so, N as xo, P as io, Q as lo, R as mo, ac as po, ad as fo, T as no, U as Co, ae as uo, af as co, e as go, X as To, ag as Ao, ah as Io } from "../chunks/types.C7C66KUV.js";
 import { default as Do } from "./bicolor-picker.js";
 import { default as ho } from "./border-input-group.js";
 import { C as Fo } from "../chunks/color-swatch.DxxOpJXT.js";

package/library/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orangelogic/design-system",
   "type": "module",
-  "version": "3.15.0",
+  "version": "3.16.0",
   "license": "UNLICENSED",
   "types": "library/types.d.ts",
   "scripts": {

package/library/packages/events/src/cx-comment-task-mention-select.d.ts

@@ -0,0 +1,13 @@
+export type CxCommentTaskMentionSelectEvent = CustomEvent<{
+    value: {
+        id: string;
+        label: string;
+        title?: string;
+        type?: string;
+    };
+}>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-comment-task-mention-select': CxCommentTaskMentionSelectEvent;
+    }
+}

package/library/packages/events/src/events.d.ts

@@ -48,6 +48,7 @@ export * from './cx-column-resizable-change';
 export * from './cx-column-scroll';
 export * from './cx-columns-display-change';
 export * from './cx-comment-mention-select';
+export * from './cx-comment-task-mention-select';
 export * from './cx-connect';
 export * from './cx-connected';
 export * from './cx-content-builder-gallery-change';

package/library/packages/organisms/src/comment/comment.d.ts

@@ -24,6 +24,7 @@ declare global {
  * @description Replaces Cortex's current SSR comment and allows rich text editing thanks to the migration of Tiptap.
  *
  * @event {{ content: string }} cx-comment-change - Emitted when the editor's content changes.
+ * @event {{ value: { id: string, label: string, title?: string, type?: string } }} cx-comment-task-mention-select - Emitted when a task mention is selected from the task suggestion dropdown (triggered by `task-trigger-char`, `#` by default).
  * @event cx-recording-started - Emitted when the screen recorder has started.
  * @event cx-recording-stopped - Emitted when the screen recorder has stopped.
  * @event {{ error: Error }} cx-recording-error - Emitted when the screen recorder has error.
@@ -57,6 +58,47 @@ export default class CxComment extends CortexElement {
     filterName: string;
     serviceName: string;
     autocompletionViewstate: string;
+    /**
+     * Query module name for the task mention autocomplete. Task mentions
+     * (and task permalink paste conversion) stay disabled while unset.
+     */
+    taskQueryName: string;
+    /**
+     * Filter module name for the task mention autocomplete.
+     */
+    taskFilterName: string;
+    /**
+     * Optional filter module name used only to resolve pasted task permalinks,
+     * expected to match the pasted identifier exactly (unlike `task-filter-name`,
+     * whose fuzzy conditions also match title substrings). While unset, paste
+     * resolution runs through `task-filter-name` and keeps only an exact
+     * identifier match from its results.
+     */
+    taskPasteFilterName: string;
+    /**
+     * Minimum query length for the task mention autocomplete. Defaults to 0
+     * so suggestions show as soon as the trigger character is typed.
+     */
+    taskMinQueryLength: number;
+    /**
+     * The character that triggers the task mention autocomplete. Defaults
+     * to `#`.
+     */
+    taskTriggerChar: string;
+    /**
+     * Format of the task mention chip text while composing, with `[IDENTIFIER]`
+     * and `[TITLE]` placeholders — the same template the host uses for the
+     * rendered mention links. Display-only: the mention is stored as the
+     * identifier alone, so the title never enters the saved comment body.
+     */
+    taskLabelTemplate: string;
+    /**
+     * Regex source (case-insensitive, capture group 1 = identifier) matched
+     * against pasted same-origin URL paths to detect task links. Provided by
+     * the host, derived from the site's task URL template. While unset, only
+     * legacy `?TID={id}` links are detected on paste.
+     */
+    taskUrlPattern: string;
     maxCount: number;
     queryDelay: number;
     minQueryLength: number;
@@ -82,16 +124,46 @@ export default class CxComment extends CortexElement {
     private handleCopy;
     private fetchAutocompleteItems;
     getMentionItems(queryString: string): Promise<AutocompleteItem[]>;
+    getTaskMentionItems(queryString: string, filterName?: string): Promise<AutocompleteItem[]>;
     resetMention(): void;
     protected handleMenuItemClick(): void;
     private handleFullscreenClick;
     toggleFullscreen(): void;
+    /**
+     * Both mention kinds debounce their autocomplete identically; only the
+     * items getter differs. Kept as field initializers so the debounce wait
+     * captures `queryDelay` at construction time, exactly like the previous
+     * inline `_debounce` fields did.
+     */
+    private createDebouncedMentionFetch;
     private readonly debouncedFetch;
+    private readonly debouncedTaskFetch;
     private fetchItems;
+    private fetchTaskItems;
     private handleMentionSelect;
+    /**
+     * Shared activation for both suggestion kinds: anchors the shared
+     * cx-mentions popup on the suggestion decoration and wires selection.
+     * `resetAnchor` re-anchors even when an anchor is already set (contact
+     * mention start); the other paths keep the existing anchor (`??=`) so the
+     * popup does not jump while typing, relying on `onExit` → `resetMention`
+     * to clear it between suggestions.
+     */
+    private activateMention;
     private handleMentionStart;
     private handleMentionUpdate;
+    private handleTaskMentionActivate;
     private handleMentionKeyDown;
+    /**
+     * The task mention extension is created per editor init (not in the static
+     * `extensions` field) so its options read the host-applied properties
+     * (trigger char, label template, URL pattern). It is always registered —
+     * keeping the node in the schema means stored task mentions round-trip
+     * unchanged even where the feature is off — while suggestions and paste
+     * conversion stay inert until the host opts in via `task-query-name`.
+     */
+    private getTaskMentionExtension;
+    private getEditorExtensions;
     private initEditor;
     /**
      * First init must happen here: on Cortex ajax refresh the element renders while

package/library/packages/tools/src/tiptap/extensions/task-mention/index.d.ts

@@ -0,0 +1,77 @@
+import { PluginKey } from '@tiptap/pm/state';
+import { MentionNodeAttrs, MentionOptions } from '../mention';
+
+export interface TaskMentionNodeAttrs extends MentionNodeAttrs {
+    /**
+     * Snapshot of the task title at insertion time, stored as a `data-title`
+     * attribute. Display-time rendering resolves the current title server-side;
+     * this is only a fallback for plain-text contexts.
+     */
+    title?: string | null;
+}
+/**
+ * A task reference resolved from a pasted permalink.
+ */
+export interface ResolvedTaskMention {
+    id: string;
+    label: string;
+    title?: string;
+}
+export type TaskMentionOptions = MentionOptions<any, TaskMentionNodeAttrs> & {
+    /**
+     * Format of the chip text shown while composing, with `[IDENTIFIER]` and
+     * `[TITLE]` placeholders (mirrors the server's TaskMentionLinkTextTemplate,
+     * which formats the rendered mention links the same way). Mentions without
+     * a title always show the identifier alone. Display-only: the mention
+     * serializes as `{char}{identifier}` regardless of this option, so the
+     * title never becomes part of the stored comment body.
+     */
+    labelTemplate?: string;
+    /**
+     * Resolves a task identifier extracted from a pasted permalink into a
+     * mention item. Return `null` when the identifier matches no task; the
+     * pasted text is then left untouched (rendered as a plain link).
+     * URL paste conversion is disabled while this is unset.
+     */
+    resolveTaskUrl?: (identifier: string) => Promise<ResolvedTaskMention | null>;
+    /**
+     * Site-specific regex source, matched case-insensitively against a pasted
+     * same-origin URL's path, with the task identifier as capture group 1.
+     * Derived server-side from the site's task URL template so paste detection
+     * always follows it. Path-based detection is disabled while unset — only
+     * legacy `?TID={id}` links are recognized then.
+     */
+    urlPattern?: string;
+};
+/**
+ * The plugin key for the task mention plugin.
+ */
+export declare const TaskMentionPluginKey: PluginKey<any>;
+/**
+ * The chip text shown in the editor for a task mention: the trigger character
+ * followed by the label template with `[IDENTIFIER]`/`[TITLE]` filled in, or
+ * by the identifier alone when the mention has no title.
+ */
+export declare function formatTaskMentionText(char: string, labelTemplate: string | undefined, identifier: string, title: string | null | undefined): string;
+/**
+ * Extracts a task identifier from a task permalink pointing at `currentOrigin`.
+ * Path detection follows `sitePattern` (the site's task URL template, compiled
+ * by `compileTaskUrlPattern`); legacy `?TID={identifier}` links are always
+ * recognized. Returns `null` for anything else (foreign origins, non-task
+ * paths, plain text).
+ */
+export declare function findTaskIdentifierInUrl(text: string, currentOrigin: string, sitePattern?: RegExp | null): string | null;
+/**
+ * Compiles the site-specific URL pattern, or returns `null` when unset or
+ * invalid (path-based paste detection then stays disabled).
+ */
+export declare function compileTaskUrlPattern(patternSource: string | undefined): RegExp | null;
+/**
+ * This extension inserts references to other tasks into the editor — the task
+ * counterpart of the contact `Mention` extension. Stored as `span.task-mention`
+ * so the contact-mention parsers never touch it.
+ * Also converts pasted task permalinks into task mentions when
+ * `resolveTaskUrl` is configured; the pasted URL is matched against the
+ * site-provided `urlPattern` (or a legacy `?TID={id}` parameter).
+ */
+export declare const TaskMention: import('@tiptap/core').Node<TaskMentionOptions, any>;

package/library/react-web-component.d.ts

@@ -7774,6 +7774,34 @@
           * 
         */
         autocompletionViewstate?: string;
+        /**
+          * Query module name for the task mention autocomplete. Task mentions (and task permalink paste conversion) stay disabled while unset.
+        */
+        taskQueryName?: string;
+        /**
+          * Filter module name for the task mention autocomplete.
+        */
+        taskFilterName?: string;
+        /**
+          * Optional filter module name used only to resolve pasted task permalinks, expected to match the pasted identifier exactly (unlike `task-filter-name`, whose fuzzy conditions also match title substrings). While unset, paste resolution runs through `task-filter-name` and keeps only an exact identifier match from its results.
+        */
+        taskPasteFilterName?: string;
+        /**
+          * Minimum query length for the task mention autocomplete. Defaults to 0 so suggestions show as soon as the trigger character is typed.
+        */
+        taskMinQueryLength?: number;
+        /**
+          * The character that triggers the task mention autocomplete. Defaults to `#`.
+        */
+        taskTriggerChar?: string;
+        /**
+          * Format of the task mention chip text while composing, with `[IDENTIFIER]` and `[TITLE]` placeholders — the same template the host uses for the rendered mention links. Display-only: the mention is stored as the identifier alone, so the title never enters the saved comment body.
+        */
+        taskLabelTemplate?: string;
+        /**
+          * Regex source (case-insensitive, capture group 1 = identifier) matched against pasted same-origin URL paths to detect task links. Provided by the host, derived from the site's task URL template. While unset, only legacy `?TID={id}` links are detected on paste.
+        */
+        taskUrlPattern?: string;
         /**
           * 
         */
@@ -7904,6 +7932,34 @@
           * 
         */
         autocompletionViewstate?: string;
+        /**
+          * Query module name for the task mention autocomplete. Task mentions (and task permalink paste conversion) stay disabled while unset.
+        */
+        taskQueryName?: string;
+        /**
+          * Filter module name for the task mention autocomplete.
+        */
+        taskFilterName?: string;
+        /**
+          * Optional filter module name used only to resolve pasted task permalinks, expected to match the pasted identifier exactly (unlike `task-filter-name`, whose fuzzy conditions also match title substrings). While unset, paste resolution runs through `task-filter-name` and keeps only an exact identifier match from its results.
+        */
+        taskPasteFilterName?: string;
+        /**
+          * Minimum query length for the task mention autocomplete. Defaults to 0 so suggestions show as soon as the trigger character is typed.
+        */
+        taskMinQueryLength?: number;
+        /**
+          * The character that triggers the task mention autocomplete. Defaults to `#`.
+        */
+        taskTriggerChar?: string;
+        /**
+          * Format of the task mention chip text while composing, with `[IDENTIFIER]` and `[TITLE]` placeholders — the same template the host uses for the rendered mention links. Display-only: the mention is stored as the identifier alone, so the title never enters the saved comment body.
+        */
+        taskLabelTemplate?: string;
+        /**
+          * Regex source (case-insensitive, capture group 1 = identifier) matched against pasted same-origin URL paths to detect task links. Provided by the host, derived from the site's task URL template. While unset, only legacy `?TID={id}` links are detected on paste.
+        */
+        taskUrlPattern?: string;
         /**
           * 
         */
@@ -9240,6 +9296,34 @@
           * 
         */
         autocompletionViewstate?: string;
+        /**
+          * Query module name for the task mention autocomplete. Task mentions (and task permalink paste conversion) stay disabled while unset.
+        */
+        taskQueryName?: string;
+        /**
+          * Filter module name for the task mention autocomplete.
+        */
+        taskFilterName?: string;
+        /**
+          * Optional filter module name used only to resolve pasted task permalinks, expected to match the pasted identifier exactly (unlike `task-filter-name`, whose fuzzy conditions also match title substrings). While unset, paste resolution runs through `task-filter-name` and keeps only an exact identifier match from its results.
+        */
+        taskPasteFilterName?: string;
+        /**
+          * Minimum query length for the task mention autocomplete. Defaults to 0 so suggestions show as soon as the trigger character is typed.
+        */
+        taskMinQueryLength?: number;
+        /**
+          * The character that triggers the task mention autocomplete. Defaults to `#`.
+        */
+        taskTriggerChar?: string;
+        /**
+          * Format of the task mention chip text while composing, with `[IDENTIFIER]` and `[TITLE]` placeholders — the same template the host uses for the rendered mention links. Display-only: the mention is stored as the identifier alone, so the title never enters the saved comment body.
+        */
+        taskLabelTemplate?: string;
+        /**
+          * Regex source (case-insensitive, capture group 1 = identifier) matched against pasted same-origin URL paths to detect task links. Provided by the host, derived from the site's task URL template. While unset, only legacy `?TID={id}` links are detected on paste.
+        */
+        taskUrlPattern?: string;
         /**
           * 
         */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orangelogic/design-system",
   "type": "module",
-  "version": "3.15.0",
+  "version": "3.16.0",
   "license": "UNLICENSED",
   "types": "library/types.d.ts",
   "scripts": {