Add negated example for escape sequences

src/expression.ts

@@ -1205,6 +1205,19 @@ export const exactly = r.exactly;
  * ```js
  * /[\123]/
  * ```
+ *
+ * @example Negated token
+ *
+ * ```js
+ * not.octal`123`
+ * not(octal('123'))
+ * ```
+ *
+ * RegExp equivalent:
+ *
+ * ```js
+ * /[^\123]/
+ * ```
  */
 export const octal = r.octal;
 
@@ -1228,6 +1241,19 @@ export const octal = r.octal;
  * ```js
  * /\x3f/
  * ```
+ *
+ * @example Negated token
+ *
+ * ```js
+ * not.hex`3f`
+ * not(hex('3f'))
+ * ```
+ *
+ * RegExp equivalent:
+ *
+ * ```js
+ * /[^\x3f]/
+ * ```
  */
 export const hex = r.hex;
 
@@ -1251,6 +1277,19 @@ export const hex = r.hex;
  * ```js
  * /\u3ef1/
  * ```
+ *
+ * @example Negated token
+ *
+ * ```js
+ * not.unicode`3ef1`
+ * not(unicode('3ef1'))
+ * ```
+ *
+ * RegExp equivalent:
+ *
+ * ```js
+ * /[^\u3ef1]/
+ * ```
  */
 export const unicode = r.unicode;
 
@@ -1279,6 +1318,22 @@ export const unicode = r.unicode;
  * /\cj/
  * /\cJ/
  * ```
+ *
+ * @example Negated token
+ *
+ * ```js
+ * not.control`j`
+ * not(control('j'))
+ * not.control`J`
+ * not(control('J'))
+ * ```
+ *
+ * RegExp equivalent:
+ *
+ * ```js
+ * /[^\cj]/
+ * /[^\cJ]/
+ * ```
  */
 export const control = r.control;
 

src/types.ts

@@ -742,6 +742,7 @@ export interface RegExpToken {
    * @deprecated Octal escape sequences (\\ followed by one, two, or three octal digits) are deprecated in string and regular expression literals.
    *
    * ----------------------
+   *
    * Match a character with the given code point in base-8.
    *
    * Notes:
@@ -763,6 +764,19 @@ export interface RegExpToken {
    * ```js
    * /[\123]/
    * ```
+   *
+   * @example Negated token
+   *
+   * ```js
+   * not.octal`123`
+   * not(octal('123'))
+   * ```
+   *
+   * RegExp equivalent:
+   *
+   * ```js
+   * /[^\123]/
+   * ```
    */
   get octal(): LiteralFunction & IncompleteToken;
 
@@ -786,6 +800,19 @@ export interface RegExpToken {
    * ```js
    * /\x3f/
    * ```
+   *
+   * @example Negated token
+   *
+   * ```js
+   * not.hex`3f`
+   * not(hex('3f'))
+   * ```
+   *
+   * RegExp equivalent:
+   *
+   * ```js
+   * /[^\x3f]/
+   * ```
    */
   get hex(): LiteralFunction & IncompleteToken;
 
@@ -809,6 +836,19 @@ export interface RegExpToken {
    * ```js
    * /\u3ef1/
    * ```
+   *
+   * @example Negated token
+   *
+   * ```js
+   * not.unicode`3ef1`
+   * not(unicode('3ef1'))
+   * ```
+   *
+   * RegExp equivalent:
+   *
+   * ```js
+   * /[^\u3ef1]/
+   * ```
    */
   get unicode(): LiteralFunction & IncompleteToken;
 
@@ -837,6 +877,22 @@ export interface RegExpToken {
    * /\cj/
    * /\cJ/
    * ```
+   *
+   * @example Negated token
+   *
+   * ```js
+   * not.control`j`
+   * not.control('j')
+   * not.control`J`
+   * not.control('J')
+   * ```
+   *
+   * RegExp equivalent:
+   *
+   * ```js
+   * /[^\cj]/
+   * /[^\cJ]/
+   * ```
    */
   get control(): ControlFunction & IncompleteToken;