(tpl*) - JavaScript

template literals matched by a pseudo-evaluated value that includes interpolations

(tpl* val tag?)

Where:

1. val: the text pattern to find when template parts are joined *
2. tag: the tag function (the gql in gql`...`) *

Matching:

1. template literals, e.g. `hello ${name}`
2. tagged template literals, e.g. gql`query { ... }`

Behavior

• Pseudo-evaluates templates by concatenating literal fragments and interpolation identifiers/literals in order.
• Expressions that are not identifiers or literals contribute no text to the evaluated value.

Examples

Locate GraphQL queries that request PII fields.

(tpl* /email|ssn/i gql)

Selects in lines { 1 } but not in { 2, 3 }:

const q1 = gql`query User { id email }`
const q2 = gql`query User { id name }`
const q3 = sql`SELECT email FROM users`

---

Find URLs built via template strings before migrating to a URL builder.

(tpl* /https?:/)

Selects in lines { 1, 2 } but not in { 3 }:

const url1 = `https://api.example.com/users/${id}`
const url2 = `http://localhost:${port}/health`
const url3 = `/users/${id}`

---

Remove !important from styled-components templates.

(tpl* /!important/ (mem div styled))

Selects in lines { 0 } but not in { 0, 0 }:

const Button = styled.div`
  color: red !important;
`
const Badge = styled.span`
  color: blue !important;
`
const Link = styled.div`
  color: red;
`

---

Arguments

val

1. Identifier
2. String
3. Pattern

Does NOT support: Composition — Free-form Selection — Refinement — Replacement

tag

1. Identifier: shorthand for (id)
   
2. Pattern: shorthand for (id)
   
3. (:into)
4. (:nearest)
5. (:and)
6. (:or)
7. (:not)
8. (:text)
9. (:kind)
10. (:replace)
11. (:replace-in)
12. (:capture)
13. (:ref)
14. (arr)
15. (attr)
16. (bool)
17. (call)
18. (child)
19. (comp)
20. (export)
21. (fun)
22. (id)
23. (id+)
24. (import)
25. (jsx)
26. (mem)
27. (null)
28. (num)
29. (obj)
30. (of)
31. (prop)
32. (regex)
33. (regex+)
34. (str)
35. (str*)
36. (str+)
37. (tpl)
38. (tpl*)
39. (var)