docs(pos): source-grounded payment/storage JSDoc corrections (audit proposal)

packages/ui-extensions/src/surfaces/point-of-sale/types/payment.ts

@@ -1,5 +1,10 @@
 /**
  * The available payment method types for POS transactions.
+ *
+ * Not every value is produced in every context. `Unknown` is returned only for
+ * sale transactions whose payment details can't be classified. On return and
+ * exchange transactions, unrecognized payment gateways are returned as
+ * `Custom`. `CardPresentRefund` isn't currently returned by POS.
  * @publicDocs
  */
 export type PaymentMethod =

packages/ui-extensions/src/surfaces/point-of-sale/types/storage.ts

@@ -47,7 +47,7 @@ export interface Storage<
   current: SubscribableStorage<BaseStorageTypes>;
 
   /**
-   * Stores a value under the specified key, overwriting any existing value. Values must be JSON-serializable and return `StorageError` when storage limits are exceeded. Commonly used for storing user preferences, caching API responses, or passing contextual data from tiles to modals.
+   * Stores a value under the specified key, overwriting any existing value. Values must be JSON-serializable, and the promise rejects with a `StorageError` when storage limits are exceeded. Values are JSON-serialized on write: `undefined` properties are dropped, `NaN` and `Infinity` become `null`, and `Date` objects become ISO strings. Keys are limited to 1024 UTF-16 code units, and values to 1,048,576 code units of their JSON serialization. Commonly used for storing user preferences, caching API responses, or passing contextual data from tiles to modals.
    *
    * @param key - The key to set the value for.
    * @param value - The value to set for the key.