(tpl) - JavaScript

template literals (`...`) and tagged template literals like html... or sql...

(tpl quasis? expr? tag?)

Where:

1. quasis: the literal string fragments (the hello and ! in `hello ${name}!`) *
2. expr: the interpolation expressions (the userId in `${userId}`) *
3. tag: the tag function (the html in html`...`) *

Matching:

1. template literals, e.g. `hello ${name}`
2. tagged template literals, e.g. html`<div>${content}</div>`

Behavior

• Empty templates like are matched.

Examples

Audit SQL tagged templates before moving to parameterized queries.

(tpl /select|insert|update|delete/i _ sql)

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

const q1 = sql`SELECT * FROM users WHERE id = ${userId}`
const q2 = sql`UPDATE users SET active = 1`
const q3 = `SELECT * FROM users`

---

Find URLs built with userId interpolation to migrate to a URL builder.

(tpl /\/users\// (id userId))

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

const url = `/users/${userId}`
const url2 = `/users/${otherId}`
const url3 = `/users/42`

---

Clean up CSS-in-JS templates that still use !important.

(tpl /!important/ _ css)

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

const button = css`
  color: red !important;
`
const card = css`
  color: blue;
`
const other = styled.div`
  color: red !important;
`

---

Arguments

quasis

1. Identifier: shorthand for (str)
   
2. String: shorthand for (str)
   
3. Pattern: shorthand for (str)
   
4. (str)
   
5. (:into)
6. (:nearest)
7. (:and)
8. (:or)
9. (:not)
10. (:text)
11. (:kind)
12. (:replace)
13. (:replace-in)
14. (:capture)

expr

1. (:into)
2. (:nearest)
3. (:and)
4. (:or)
5. (:not)
6. (:text)
7. (:kind)
8. (:replace)
9. (:replace-in)
10. (:capture)
11. (arr)
12. (bin)
13. (bool)
14. (call)
15. (comp)
16. (fun)
17. (id)
18. (id+)
19. (jsx)
20. (mem)
21. (null)
22. (num)
23. (obj)
24. (of)
25. (regex)
26. (regex+)
27. (str)
28. (str*)
29. (str+)
30. (tpl)
31. (tpl*)

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)