update readme and jsdoc

packages/babel-plugin-extract-messages/src/index.ts

@@ -8,7 +8,6 @@ import {
   isObjectExpression,
 } from "@babel/types"
 import type { PluginObj, PluginPass, NodePath } from "@babel/core"
-import {} from "@babel/core"
 import type { Hub } from "@babel/traverse"
 
 type BabelTypes = typeof BabelTypesNamespace

packages/format-po/README.md

@@ -39,7 +39,7 @@ export default {
 
 Possible options:
 
-```ts
+````ts
 export type PoFormatterOptions = {
   /**
    * Print places where message is used
@@ -54,14 +54,14 @@ export type PoFormatterOptions = {
    * @default true
    */
   lineNumbers?: boolean
-  
+
   /**
    * Print `js-lingui-id: Xs4as` statement in extracted comments section
    *
    * @default false
    */
   printLinguiId?: boolean
-  
+
   /**
    * By default, the po-formatter treats the pair `msgid` + `msgctx` as the source
    * for generating an ID by hashing its value.
@@ -76,8 +76,32 @@ export type PoFormatterOptions = {
    * @default false
    */
   explicitIdAsDefault?: boolean
+
+  /**
+   * Print values for unnamed placeholders as comments for each message.
+   *
+   * This can give more context to translators for better translations.
+   *
+   * By default first 3 placeholders are shown.
+   *
+   * Example:
+   *
+   * ```js
+   * t`Hello ${user.name} ${value}`
+   * ```
+   *
+   * This will be extracted as
+   *
+   * ```po
+   * #. placeholder {0}: user.name
+   * msgid "Hello {0} {value}"
+   * ```
+   *
+   * @default true
+   */
+  printPlaceholdersInComments?: boolean | { limit?: number }
 }
-```
+````
 
 ## License
 

packages/format-po/src/po.ts

@@ -76,7 +76,7 @@ export type PoFormatterOptions = {
    * This will be extracted as
    *
    * ```po
-   * #. ph: {0} = user.name
+   * #. placeholder {0}: user.name
    * msgid "Hello {0} {value}"
    * ```
    *