@design.estate/dees-catalog 6.6.0 → 6.7.0

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

@@ -307,6 +307,73 @@ export interface IHarnessSessionMeta {
   draggable?: boolean;
 }
 
+/** Host-owned metadata for a resource that can be associated with a harness session. */
+export interface IHarnessResourceMeta<TState extends string = string> {
+  /** Stable identity used by selection and association records. */
+  id: string;
+  /** Open resource kind supplied by the host, for example `terminal`, `file`, or `browser`. */
+  kind: string;
+  title: string;
+  /** Optional dees-icon name (e.g. `lucide:FileText`). */
+  icon?: string;
+  preview?: string;
+  createdAt?: number;
+  updatedAt?: number;
+  /** Optional host-defined display state. */
+  state?: TState;
+}
+
+/** A controlled zero-or-one session association for one resource. */
+export interface IHarnessResourceAssociation {
+  resourceId: string;
+  sessionId: string;
+}
+
+export interface IHarnessResourceEventDetail<TState extends string = string> {
+  resource: IHarnessResourceMeta<TState>;
+  sessionId: string | null;
+}
+
+export type THarnessResourceAssociationInteractionSource = 'drop' | 'action' | 'keyboard';
+
+export type THarnessResourceAssociationRequestDetail<TState extends string = string> =
+  | {
+      intent: 'attach';
+      resource: IHarnessResourceMeta<TState>;
+      fromSessionId: null;
+      toSessionId: string;
+      source: THarnessResourceAssociationInteractionSource;
+    }
+  | {
+      intent: 'detach';
+      resource: IHarnessResourceMeta<TState>;
+      fromSessionId: string;
+      toSessionId: null;
+      source: THarnessResourceAssociationInteractionSource;
+    }
+  | {
+      intent: 'reassign';
+      resource: IHarnessResourceMeta<TState>;
+      fromSessionId: string;
+      toSessionId: string;
+      source: THarnessResourceAssociationInteractionSource;
+    };
+
+export type THarnessResourceContextSource = 'pointer' | 'action' | 'keyboard';
+
+/** Detail of `harness-resource-context`; the host owns the actual menu. */
+export interface IHarnessResourceContextDetail<TState extends string = string>
+  extends IHarnessResourceEventDetail<TState> {
+  clientX: number;
+  clientY: number;
+  source: THarnessResourceContextSource;
+  originalEvent: MouseEvent | KeyboardEvent;
+  /** Routes a host menu choice through the component's validated controlled request event. */
+  requestAssociation: (toSessionId: string | null) => boolean;
+  /** Closes the external-menu disclosure state and restores focus to its invoking control. */
+  close: () => void;
+}
+
 /** Detail of `harness-session-context`, fired on right-click of a session item. */
 export interface IHarnessSessionContextDetail {
   session: IHarnessSessionMeta;