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}"
  * ```
  *