@design.estate/dees-catalog 11.2.2 → 12.0.0

package/ts_web/elements/00group-harness/index.ts

@@ -12,6 +12,7 @@ export * from './dees-harness-overflow-text.js';
 export * from './dees-harness-chat/index.js';
 export * from './dees-harness-composer/index.js';
 export * from './dees-harness-content-blocks/index.js';
+export * from './dees-harness-conversation-picker/index.js';
 export * from './dees-harness-message/index.js';
 export * from './dees-harness-permission-card/index.js';
 export * from './dees-harness-question-card/index.js';

package/ts_web/elements/00group-harness/interfaces.ts

@@ -401,49 +401,66 @@ export interface IHarnessResourceMeta<TState extends string = string> {
 }
 
 /**
- * A controlled zero-or-one association for one resource. The target is any
- * other list item — a session or another resource such as a terminal.
+ * The controlled set of associations for one resource. A resource can be attached to several
+ * items at once, and a target is any other list item — a session or another resource such as a
+ * terminal. An empty array is an unattached resource.
  */
 export interface IHarnessResourceAssociation {
   resourceId: string;
-  target: IHarnessSessionListItemRef;
+  targets: IHarnessSessionListItemRef[];
 }
 
 export interface IHarnessResourceEventDetail<TState extends string = string> {
   resource: IHarnessResourceMeta<TState>;
-  /** The controlled association target, or null when the resource is unattached. */
-  target: IHarnessSessionListItemRef | null;
+  /** The controlled association targets; empty when the resource is unattached. */
+  targets: IHarnessSessionListItemRef[];
 }
 
 /**
- * Association is an explicit host action, never a drop: dragging a resource
- * only moves it inside the ordered list.
+ * Attaching is an explicit choice, never an accident of reordering: a drag only attaches when it
+ * is released on the centre of a row, and the edges of that same row stay positional. Keyboard
+ * moves are always positional; keyboard attaching goes through the host's menu.
  */
-export type THarnessResourceAssociationInteractionSource = 'action' | 'keyboard';
+export type THarnessResourceAssociationInteractionSource = 'action' | 'keyboard' | 'pointer';
 
-export type THarnessResourceAssociationRequestDetail<TState extends string = string> =
+/**
+ * A validated association request. `attach` adds the first target, `attach-additional` adds
+ * another one beside existing targets, `move` replaces one specific target, and `detach` removes
+ * one. `fromTarget` always names the attachment being replaced or removed, never the whole set.
+ */
+export type THarnessResourceAssociateDetail<TState extends string = string> =
   | {
-      intent: 'attach';
+      mode: 'attach';
       resource: IHarnessResourceMeta<TState>;
       fromTarget: null;
       toTarget: IHarnessSessionListItemRef;
       source: THarnessResourceAssociationInteractionSource;
     }
   | {
-      intent: 'detach';
+      mode: 'attach-additional';
       resource: IHarnessResourceMeta<TState>;
-      fromTarget: IHarnessSessionListItemRef;
-      toTarget: null;
+      fromTarget: null;
+      toTarget: IHarnessSessionListItemRef;
       source: THarnessResourceAssociationInteractionSource;
     }
   | {
-      intent: 'reassign';
+      mode: 'move';
       resource: IHarnessResourceMeta<TState>;
       fromTarget: IHarnessSessionListItemRef;
       toTarget: IHarnessSessionListItemRef;
       source: THarnessResourceAssociationInteractionSource;
+    }
+  | {
+      mode: 'detach';
+      resource: IHarnessResourceMeta<TState>;
+      fromTarget: IHarnessSessionListItemRef;
+      toTarget: null;
+      source: THarnessResourceAssociationInteractionSource;
     };
 
+/** Explicit mode for `requestAssociation`; omitted lets the list infer it from the current set. */
+export type THarnessResourceAssociateMode = THarnessResourceAssociateDetail['mode'];
+
 export type THarnessResourceContextSource = 'pointer' | 'action' | 'keyboard';
 
 /** Detail of `harness-resource-context`; the host owns the actual menu. */
@@ -453,8 +470,16 @@ export interface IHarnessResourceContextDetail<TState extends string = string>
   clientY: number;
   source: THarnessResourceContextSource;
   originalEvent: MouseEvent | KeyboardEvent;
-  /** Routes a host menu choice through the component's validated controlled request event. */
-  requestAssociation: (toTarget: IHarnessSessionListItemRef | null) => boolean;
+  /**
+   * Routes a host menu choice through the component's validated controlled request event. With no
+   * mode, an unattached resource attaches and a singly attached one moves; a resource with several
+   * attachments is refused, because only the host knows which attachment was meant.
+   */
+  requestAssociation: (
+    toTarget: IHarnessSessionListItemRef | null,
+    mode?: THarnessResourceAssociateMode,
+    fromTarget?: IHarnessSessionListItemRef | null,
+  ) => boolean;
   /** Closes the external-menu disclosure state and restores focus to its invoking control. */
   close: () => void;
 }