chore: tighten JSDoc comments for public package

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: vctrchu

packages/ui-extensions/src/surfaces/point-of-sale/api/data-target-api/data-target-api.ts

@@ -2,9 +2,6 @@ import {CartApi} from '../cart-api/cart-api';
 import {StandardApi} from '../standard/standard-api';
 
 /**
- * API surface for non-rendering data targets like `pos.app.ready.data`.
- * Provides the full POS extension API suite (StandardApi + CartApi) without
- * UI components. Data targets run in the background and process events
- * without rendering.
+ * API surface for non-rendering data extension targets.
  */
 export type DataTargetApi<T> = StandardApi<T> & CartApi;

packages/ui-extensions/src/surfaces/point-of-sale/extension-targets.ts

@@ -48,11 +48,8 @@ export interface EventExtensionTargets {
 export interface DataExtensionTargets {
   /**
    * A persistent background extension that starts when POS loads and runs for
-   * the session's lifetime. Use this target for observing POS events like cart
-   * updates and transaction completions without rendering UI.
-   *
-   * Register event listeners via `shopify.addEventListener()` and persist state
-   * via `shopify.storage` for companion UI targets to read.
+   * the session's lifetime. Use this target to observe POS events without
+   * rendering UI.
    */
   'pos.app.ready.data': RunnableExtension<
     DataTargetApi<'pos.app.ready.data'>,