@semiont/core 0.2.35-build.100 → 0.2.35-build.102

package/README.md

@@ -279,7 +279,7 @@ Semiont follows a **spec-first architecture**:
 - HTTP client & convenience re-exports → `@semiont/api-client`
 - Backend internal implementation → imports from `@semiont/core`
 
-**Type Generation Flow**: OpenAPI spec → `@semiont/core/src/types.ts` (via `openapi-typescript`) → re-exported by `@semiont/api-client` for convenience. This ensures no circular dependencies and clear build order.
+**Type Yield Flow**: OpenAPI spec → `@semiont/core/src/types.ts` (via `openapi-typescript`) → re-exported by `@semiont/api-client` for convenience. This ensures no circular dependencies and clear build order.
 
 ## Development
 

package/dist/index.d.ts

@@ -2002,7 +2002,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/resources/{resourceId}/annotations/{annotationId}/generate-resource-stream": {
+    "/resources/{resourceId}/annotations/{annotationId}/yield-resource-stream": {
         parameters: {
             query?: never;
             header?: never;
@@ -2029,7 +2029,7 @@ interface paths {
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["GenerateResourceStreamRequest"];
+                    "application/json": components["schemas"]["YieldResourceStreamRequest"];
                 };
             };
             responses: {
@@ -2410,7 +2410,7 @@ interface components {
             sourceResource: components["schemas"]["ResourceDescriptor"];
             targetResource?: components["schemas"]["ResourceDescriptor"] | null;
             /** @description Generation context for this annotation */
-            context?: components["schemas"]["GenerationContext"];
+            context?: components["schemas"]["YieldContext"];
             /** @description DEPRECATED: Use 'context' instead. Legacy source context format. */
             sourceContext?: {
                 before: string;
@@ -2663,7 +2663,7 @@ interface components {
             data: string;
             id?: string;
         };
-        GenerateResourceFromAnnotationRequest: {
+        YieldResourceFromAnnotationRequest: {
             /** @description Optional name for the generated resource */
             name?: string;
             /** @description Entity types for the generated resource */
@@ -2673,12 +2673,12 @@ interface components {
             /** @description Language code (e.g., 'en', 'es') */
             language?: string;
         };
-        GenerateResourceFromAnnotationResponse: {
+        YieldResourceFromAnnotationResponse: {
             resource: components["schemas"]["ResourceDescriptor"];
             annotation: components["schemas"]["Annotation"];
             generated: boolean;
         };
-        GenerateResourceRequest: {
+        YieldResourceRequest: {
             /** @description Resource ID containing the annotation */
             resourceId: string;
             /** @description Custom title for generated resource */
@@ -2688,7 +2688,7 @@ interface components {
             /** @description Language locale (e.g., "es", "fr", "ja") */
             language?: string;
         };
-        GenerateResourceStreamRequest: {
+        YieldResourceStreamRequest: {
             /** @description Custom title for generated resource */
             title?: string;
             /** @description Custom prompt for content generation */
@@ -2696,7 +2696,7 @@ interface components {
             /** @description Language locale for generated content (e.g., "es", "fr", "ja") */
             language?: string;
             /** @description Generation context including source document excerpts and metadata */
-            context: components["schemas"]["GenerationContext"];
+            context: components["schemas"]["YieldContext"];
             /** @description Inference temperature (0.0 = focused, 1.0 = creative) */
             temperature?: number;
             /** @description Maximum tokens to generate */
@@ -2926,11 +2926,11 @@ interface components {
         } & {
             [key: string]: unknown;
         };
-        ResolveAnnotationRequest: {
+        BindAnnotationRequest: {
             /** @description Target resource ID to resolve reference to */
             resourceId: string;
         };
-        ResolveAnnotationResponse: {
+        BindAnnotationResponse: {
             annotation: components["schemas"]["Annotation"];
             targetResource?: components["schemas"]["ResourceDescriptor"] | null;
         };
@@ -3158,7 +3158,7 @@ interface components {
             conformsTo?: string;
         };
         /** @description Context information used for AI generation. Includes source document excerpts and metadata. */
-        GenerationContext: {
+        YieldContext: {
             /** @description Text context from the source document */
             sourceContext: {
                 /** @description Text appearing before the selected passage */
@@ -3696,13 +3696,13 @@ declare function isResourceEvent(event: any): event is StoredEvent;
  */
 
 type Selector = components['schemas']['TextPositionSelector'] | components['schemas']['TextQuoteSelector'] | components['schemas']['SvgSelector'] | components['schemas']['FragmentSelector'];
-type GenerationContext = components['schemas']['GenerationContext'];
+type YieldContext = components['schemas']['YieldContext'];
 type Annotation$2 = components['schemas']['Annotation'];
 type Motivation = components['schemas']['Motivation'];
 /**
- * Progress state for resource generation workflow
+ * Progress state for resource yield workflow
  */
-interface GenerationProgress {
+interface YieldProgress {
     status: 'started' | 'fetching' | 'generating' | 'creating' | 'complete' | 'error';
     referenceId: string;
     resourceName?: string;
@@ -3725,13 +3725,13 @@ interface SelectionData {
     suffix?: string;
 }
 /**
- * Progress state for annotation workflows (manual and assisted)
+ * Progress state for mark workflows (manual and assisted)
  *
  * Unified progress interface supporting different annotation strategies:
  * - Reference annotation: entity-type steps
  * - Other motivations: percentage-based progress
  */
-interface AnnotationProgress {
+interface MarkProgress {
     status: string;
     message?: string;
     /** Reference annotation: currently scanning entity type */
@@ -3757,68 +3757,76 @@ interface AnnotationProgress {
  * Unified event map for all application events
  *
  * Organized by workflow ("flows"):
- * 1. Attention Flow - Annotation hover/focus/sparkle coordination
- * 2. Annotation Flow - Manual + AI-assisted annotation (all motivations)
- * 3. Context Retrieval Flow - LLM context fetching from annotations
- * 4. Generation Flow - Resource generation from references
- * 5. Resolution Flow - Reference linking/resolution (search modal)
+ * 1. Yield Flow - Resource generation from references
+ * 2. Mark Flow - Manual + AI-assisted annotation (all motivations)
+ * 3. Bind Flow - Reference linking/resolution (search modal)
+ * 4. Gather Flow - LLM context fetching from annotations
+ * 5. Browse Flow - Panel, sidebar, and application routing
+ * 6. Beckon Flow - Annotation hover/focus/sparkle coordination
  *
- * Plus infrastructure events (domain events, SSE, resource operations, navigation, settings)
+ * Plus infrastructure events (domain events, SSE, resource operations, settings)
  */
 type EventMap = {
     'make-meaning:event': ResourceEvent;
-    'attend:hover': {
-        annotationId: string | null;
-    };
-    'attend:click': {
-        annotationId: string;
-        motivation: Motivation;
-    };
-    'attend:focus': {
-        annotationId: string | null;
-    };
-    'attend:sparkle': {
-        annotationId: string;
+    'yield:modal-open': {
+        annotationUri: string;
+        resourceUri: string;
+        defaultTitle: string;
     };
-    'attend:panel-toggle': {
-        panel: string;
+    'yield:request': {
+        annotationUri: string;
+        resourceUri: string;
+        options: {
+            title: string;
+            prompt?: string;
+            language?: string;
+            temperature?: number;
+            maxTokens?: number;
+            context: YieldContext;
+        };
     };
-    'attend:panel-open': {
-        panel: string;
-        scrollToAnnotationId?: string;
-        motivation?: string;
+    'yield:progress': YieldProgress;
+    'yield:finished': YieldProgress;
+    'yield:failed': {
+        error: Error;
     };
-    'attend:panel-close': void;
-    'annotate:select-comment': SelectionData;
-    'annotate:select-tag': SelectionData;
-    'annotate:select-assessment': SelectionData;
-    'annotate:select-reference': SelectionData;
-    'annotate:requested': {
+    'yield:representation-added': Extract<ResourceEvent, {
+        type: 'representation.added';
+    }>;
+    'yield:representation-removed': Extract<ResourceEvent, {
+        type: 'representation.removed';
+    }>;
+    'yield:clone': void;
+    'mark:select-comment': SelectionData;
+    'mark:select-tag': SelectionData;
+    'mark:select-assessment': SelectionData;
+    'mark:select-reference': SelectionData;
+    'mark:requested': {
         selector: Selector | Selector[];
         motivation: Motivation;
     };
-    'annotate:cancel-pending': void;
-    'annotate:create': {
+    'mark:cancel-pending': void;
+    'mark:create': {
         motivation: Motivation;
         selector: Selector | Selector[];
         body: components['schemas']['AnnotationBody'][];
     };
-    'annotate:created': {
+    'mark:created': {
         annotation: Annotation$2;
     };
-    'annotate:create-failed': {
+    'mark:create-failed': {
         error: Error;
     };
-    'annotate:delete': {
+    'mark:delete': {
         annotationId: string;
     };
-    'annotate:deleted': {
+    'mark:deleted': {
         annotationId: string;
     };
-    'annotate:delete-failed': {
+    'mark:delete-failed': {
         error: Error;
     };
-    'annotate:assist-request': {
+    'mark:assist-request': {
         motivation: Motivation;
         options: {
             instructions?: string;
@@ -3830,56 +3838,64 @@ type EventMap = {
             categories?: string[];
         };
     };
-    'annotate:progress': AnnotationProgress;
-    'annotate:assist-finished': {
+    'mark:progress': MarkProgress;
+    'mark:assist-finished': {
         motivation?: Motivation;
         resourceUri?: ResourceUri;
-        progress?: AnnotationProgress;
+        progress?: MarkProgress;
     };
-    'annotate:assist-failed': Extract<ResourceEvent, {
+    'mark:assist-failed': Extract<ResourceEvent, {
         type: 'job.failed';
     }>;
-    'annotate:assist-cancelled': void;
-    'annotate:progress-dismiss': void;
-    'annotate:mode-toggled': void;
-    'annotate:selection-changed': {
+    'mark:assist-cancelled': void;
+    'mark:progress-dismiss': void;
+    'mark:mode-toggled': void;
+    'mark:selection-changed': {
         motivation: string | null;
     };
-    'annotate:click-changed': {
+    'mark:click-changed': {
         action: string;
     };
-    'annotate:shape-changed': {
+    'mark:shape-changed': {
         shape: string;
     };
-    'annotate:added': Extract<ResourceEvent, {
+    'mark:added': Extract<ResourceEvent, {
         type: 'annotation.added';
     }>;
-    'annotate:removed': Extract<ResourceEvent, {
+    'mark:removed': Extract<ResourceEvent, {
         type: 'annotation.removed';
     }>;
-    'annotate:body-updated': Extract<ResourceEvent, {
+    'mark:body-updated': Extract<ResourceEvent, {
         type: 'annotation.body.updated';
     }>;
-    'annotate:entity-tag-added': Extract<ResourceEvent, {
+    'mark:entity-tag-added': Extract<ResourceEvent, {
         type: 'entitytag.added';
     }>;
-    'annotate:entity-tag-removed': Extract<ResourceEvent, {
+    'mark:entity-tag-removed': Extract<ResourceEvent, {
         type: 'entitytag.removed';
     }>;
-    'resolve:create-manual': {
+    'mark:archive': void;
+    'mark:archived': Extract<ResourceEvent, {
+        type: 'resource.archived';
+    }>;
+    'mark:unarchive': void;
+    'mark:unarchived': Extract<ResourceEvent, {
+        type: 'resource.unarchived';
+    }>;
+    'bind:create-manual': {
         annotationUri: string;
         title: string;
         entityTypes: string[];
     };
-    'resolve:link': {
+    'bind:link': {
         annotationUri: string;
         searchTerm: string;
     };
-    'resolve:search-requested': {
+    'bind:search-requested': {
         referenceId: string;
         searchTerm: string;
     };
-    'resolve:update-body': {
+    'bind:update-body': {
         annotationUri: string;
         resourceId: string;
         operations: Array<{
@@ -3889,61 +3905,73 @@ type EventMap = {
             newItem?: components['schemas']['AnnotationBody'];
         }>;
     };
-    'resolve:body-updated': {
+    'bind:body-updated': {
         annotationUri: string;
     };
-    'resolve:body-update-failed': {
+    'bind:body-update-failed': {
         error: Error;
     };
-    'correlate:requested': {
+    'gather:requested': {
         annotationUri: string;
         resourceUri: string;
     };
-    'correlate:complete': {
+    'gather:complete': {
         annotationUri: string;
-        context: GenerationContext;
+        context: YieldContext;
     };
-    'correlate:failed': {
+    'gather:failed': {
         annotationUri: string;
         error: Error;
     };
-    'generate:modal-open': {
-        annotationUri: string;
-        resourceUri: string;
-        defaultTitle: string;
+    'browse:click': {
+        annotationId: string;
+        motivation: Motivation;
     };
-    'generate:request': {
-        annotationUri: string;
-        resourceUri: string;
-        options: {
-            title: string;
-            prompt?: string;
-            language?: string;
-            temperature?: number;
-            maxTokens?: number;
-            context: GenerationContext;
-        };
+    'browse:panel-toggle': {
+        panel: string;
     };
-    'generate:progress': GenerationProgress;
-    'generate:finished': GenerationProgress;
-    'generate:failed': {
-        error: Error;
+    'browse:panel-open': {
+        panel: string;
+        scrollToAnnotationId?: string;
+        motivation?: string;
+    };
+    'browse:panel-close': void;
+    'browse:sidebar-toggle': void;
+    'browse:resource-close': {
+        resourceId: string;
+    };
+    'browse:resource-reorder': {
+        oldIndex: number;
+        newIndex: number;
+    };
+    'browse:link-clicked': {
+        href: string;
+        label?: string;
+    };
+    'browse:router-push': {
+        path: string;
+        reason?: string;
+    };
+    'browse:external-navigate': {
+        url: string;
+        resourceId?: string;
+        cancelFallback: () => void;
+    };
+    'browse:reference-navigate': {
+        documentId: string;
+    };
+    'browse:entity-type-clicked': {
+        entityType: string;
+    };
+    'beckon:hover': {
+        annotationId: string | null;
+    };
+    'beckon:focus': {
+        annotationId: string | null;
+    };
+    'beckon:sparkle': {
+        annotationId: string;
     };
-    'generate:representation-added': Extract<ResourceEvent, {
-        type: 'representation.added';
-    }>;
-    'generate:representation-removed': Extract<ResourceEvent, {
-        type: 'representation.removed';
-    }>;
-    'generate:clone': void;
-    'resource:archive': void;
-    'resource:archived': Extract<ResourceEvent, {
-        type: 'resource.archived';
-    }>;
-    'resource:unarchive': void;
-    'resource:unarchived': Extract<ResourceEvent, {
-        type: 'resource.unarchived';
-    }>;
     'job:started': Extract<ResourceEvent, {
         type: 'job.started';
     }>;
@@ -3964,33 +3992,6 @@ type EventMap = {
     'job:cancel-requested': {
         jobType: 'annotation' | 'generation';
     };
-    'navigation:sidebar-toggle': void;
-    'navigation:resource-close': {
-        resourceId: string;
-    };
-    'navigation:resource-reorder': {
-        oldIndex: number;
-        newIndex: number;
-    };
-    'navigation:link-clicked': {
-        href: string;
-        label?: string;
-    };
-    'navigation:router-push': {
-        path: string;
-        reason?: string;
-    };
-    'navigation:external-navigate': {
-        url: string;
-        resourceId?: string;
-        cancelFallback: () => void;
-    };
-    'navigation:reference-navigate': {
-        documentId: string;
-    };
-    'navigation:entity-type-clicked': {
-        entityType: string;
-    };
     'settings:theme-changed': {
         theme: 'light' | 'dark' | 'system';
     };
@@ -4027,16 +4028,16 @@ type EventName = keyof EventMap;
  * const eventBus = new EventBus();
  *
  * // Emit events
- * eventBus.get('attend:hover').next({ annotationId: 'ann-1' });
+ * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });
  *
  * // Subscribe to events
- * const subscription = eventBus.get('attend:hover').subscribe(({ annotationId }) => {
+ * const subscription = eventBus.get('beckon:hover').subscribe(({ annotationId }) => {
  *   console.log('Hover:', annotationId);
  * });
  *
  * // Use RxJS operators
  * import { debounceTime } from 'rxjs/operators';
- * eventBus.get('attend:hover')
+ * eventBus.get('beckon:hover')
  *   .pipe(debounceTime(100))
  *   .subscribe(handleHover);
  *
@@ -4061,13 +4062,13 @@ declare class EventBus {
      * @example
      * ```typescript
      * // Emit
-     * eventBus.get('attend:hover').next({ annotationId: 'ann-1' });
+     * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });
      *
      * // Subscribe
-     * const sub = eventBus.get('attend:hover').subscribe(handleHover);
+     * const sub = eventBus.get('beckon:hover').subscribe(handleHover);
      *
      * // With operators
-     * eventBus.get('attend:hover')
+     * eventBus.get('beckon:hover')
      *   .pipe(debounceTime(100), distinctUntilChanged())
      *   .subscribe(handleHover);
      * ```
@@ -5265,4 +5266,4 @@ declare class ConfigurationError extends Error {
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { APIError, type AWSConfig, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationProgress, type AnnotationRemovedEvent, type AnnotationUri, type AppConfig, type AuthCode, type BackendServiceConfig, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, type ConfigFileReader, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type DatabaseServiceConfig, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, type EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type FilesystemServiceConfig, type FrontendServiceConfig, type GenerationContext, type GenerationProgress, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphDatabaseType, type GraphPath, type GraphServiceConfig, type InferenceServiceConfig, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type McpServiceConfig, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type ProxyServiceConfig, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, type SemiontConfig, SemiontError, type ServiceConfig, type ServicePlatformConfig, type ServicesConfig, type SiteConfig, type StoredEvent, type SystemEvent, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type ValidationResult, accessToken, annotationId, annotationIdToURI, annotationUri, authCode, baseUrl, burstBuffer, cloneToken, type components, createConfigLoader, deepMerge, didToAgent, displayConfiguration, email, entityType, extractResourceUriFromAnnotationUri, findBodyItem, formatErrors, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getNodeEnvForEnvironment, googleCredential, hasAWSConfig, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, listEnvironmentNames, mcpToken, type operations, parseAndMergeConfigs, parseEnvironment, type paths, refreshToken, resolveEnvVars, resourceAnnotationUri, resourceId, resourceIdToURI, resourceUri, searchQuery, uriToAnnotationId, uriToAnnotationIdOrPassthrough, uriToResourceId, userDID, userId, userToAgent, userToDid, validateEnvironment, validateEnvironmentConfig, validateSemiontConfig, validateSiteConfig };
+export { APIError, type AWSConfig, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AnnotationUri, type AppConfig, type AuthCode, type BackendServiceConfig, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, type ConfigFileReader, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type DatabaseServiceConfig, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, type EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type FilesystemServiceConfig, type FrontendServiceConfig, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphDatabaseType, type GraphPath, type GraphServiceConfig, type InferenceServiceConfig, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type MarkProgress, type McpServiceConfig, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type ProxyServiceConfig, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, type SemiontConfig, SemiontError, type ServiceConfig, type ServicePlatformConfig, type ServicesConfig, type SiteConfig, type StoredEvent, type SystemEvent, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type ValidationResult, type YieldContext, type YieldProgress, accessToken, annotationId, annotationIdToURI, annotationUri, authCode, baseUrl, burstBuffer, cloneToken, type components, createConfigLoader, deepMerge, didToAgent, displayConfiguration, email, entityType, extractResourceUriFromAnnotationUri, findBodyItem, formatErrors, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getNodeEnvForEnvironment, googleCredential, hasAWSConfig, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, listEnvironmentNames, mcpToken, type operations, parseAndMergeConfigs, parseEnvironment, type paths, refreshToken, resolveEnvVars, resourceAnnotationUri, resourceId, resourceIdToURI, resourceUri, searchQuery, uriToAnnotationId, uriToAnnotationIdOrPassthrough, uriToResourceId, userDID, userId, userToAgent, userToDid, validateEnvironment, validateEnvironmentConfig, validateSemiontConfig, validateSiteConfig };

package/dist/index.js

@@ -194,13 +194,13 @@ var EventBus = class {
    * @example
    * ```typescript
    * // Emit
-   * eventBus.get('attend:hover').next({ annotationId: 'ann-1' });
+   * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });
    *
    * // Subscribe
-   * const sub = eventBus.get('attend:hover').subscribe(handleHover);
+   * const sub = eventBus.get('beckon:hover').subscribe(handleHover);
    *
    * // With operators
-   * eventBus.get('attend:hover')
+   * eventBus.get('beckon:hover')
    *   .pipe(debounceTime(100), distinctUntilChanged())
    *   .subscribe(handleHover);
    * ```