(chore) remove meta-keyword and meta-string in favor of nesting

CHANGES.md

@@ -58,6 +58,8 @@ Parser:
 
 Grammars:
 
+- enh(all) `.meta-keyword` => `.meta .keyword` (nested scopes) (#3167) [Josh Goebel][]
+- enh(all) `.meta-string` => `.meta .string` (nested scopes) (#3167) [Josh Goebel][]
 - enh(swift) add `actor` keyword (#3171) [Bradley Mackey][]
 - enh(crystal) highlight variables (#3154) [Josh Goebel][]
 - fix(ruby) Heredoc without interpolation (#3154) [Josh Goebel][]

VERSION_11_UPGRADE.md

@@ -3,6 +3,7 @@
   - [Language Files](#language-files)
   - [Language Aliases](#language-aliases)
   - [Styles and CSS](#styles-and-css)
+    - [Grammar Scopes](#grammar-scopes)
   - [Behavioral changes](#behavioral-changes)
     - [API changes](#api-changes)
       - [Changes to Result Data](#changes-to-result-data)
@@ -36,14 +37,14 @@ This would matter if you are requiring any of these files directly (via Node.js
 
 - `htmlbars` has been removed. Use `handlebars` instead.
 - `c-like` has been removed. Use `c`, `cpp`, or `arduino`.
-- `sql_more` has been removed. Use `sql` instead.
+- `sql_more` has been removed. Use `sql` instead or a more specific 3rd party grammar.
 
 
 ### Language Aliases
 
 This would matter if you are using these aliases.
 
-- `php3`,`php4`,`php5`, `php6`, `php7`, and `php8` havbe been removed. Use `php` instead.
+- `php3`,`php4`,`php5`, `php6`, `php7`, and `php8` have been removed. Use `php` instead.
 - `zsh` has been removed. Use `sh` or `bash` instead.
 - `freepascal`, `lazarus`, `lpr`, and `lpm` removed. Use `delphi` instead.
 
@@ -61,6 +62,11 @@ hljs.registerAliases(["php3","php4","php5","php6","php7","php8"],{ languageName:
 - The `.hljs` CSS selector is now further scoped.  It now targets `code.hljs` (inline code) and `pre code.hljs` (code blocks). If you are using a different element you may need to update your CSS to reapply some styling.
 
 
+#### Grammar Scopes
+
+- `.meta-string` removed/deprecated.  Use `.meta .string` (a nested scope) instead. See [meta-keyword][].
+- `.meta-keyword` removed/deprecated.  Use `.meta .keyword` (a nested scope) instead. See [meta-keyword][].
+
 ### Behavioral changes
 
 #### API changes
@@ -177,3 +183,5 @@ This configuration option was deprecated in v10.5. Use a plugin or pre-render co
 ### Small Things
 
 - The `regex` utility `join` has been renamed to `_eitherRewriteBackreferences` (this has always been intended for internal use only)
+
+[meta-keyword]: https://github.com/highlightjs/highlight.js/pull/3167

docs/css-classes-reference.rst

@@ -80,9 +80,11 @@ in mind so a better choice (for best theme support) might possibly be ``string``
 | meta                     | flags, modifiers, annotations, processing                   |
 |                          | instructions, preprocessor directives, etc                  |
 +--------------------------+-------------------------------------------------------------+
-| meta-keyword             | keyword or built-in within meta construct                   |
+| meta keyword             | a keyword inside a meta block                               |
+|                          | (note this is nested, not subscoped)                        |
 +--------------------------+-------------------------------------------------------------+
-| meta-string              | string within meta construct                                |
+| meta string              | a string inside a meta block                                |
+|                          | (note this is nested, not subscoped)                        |
 +--------------------------+-------------------------------------------------------------+
 | **Tags, attributes, configs**                                                          |
 +--------------------------+-------------------------------------------------------------+

src/languages/1c.js

@@ -450,7 +450,7 @@ export default function(hljs) {
     begin: '#|&', end: '$',
     keywords: {
       $pattern: UNDERSCORE_IDENT_RE,
-      'meta-keyword': KEYWORD + METAKEYWORD
+      keyword: KEYWORD + METAKEYWORD
     },
     contains: [
       COMMENTS

src/languages/actionscript.js

@@ -121,7 +121,7 @@ export default function(hljs) {
         className: 'meta',
         beginKeywords: 'import include',
         end: /;/,
-        keywords: { 'meta-keyword': 'import include' }
+        keywords: { keyword: 'import include' }
       },
       {
         beginKeywords: 'function',

src/languages/autoit.js

@@ -83,7 +83,7 @@ export default function(hljs) {
     begin: '#',
     end: '$',
     keywords: {
-      'meta-keyword': DIRECTIVES
+      keyword: DIRECTIVES
     },
     contains: [
       {
@@ -93,13 +93,13 @@ export default function(hljs) {
       {
         beginKeywords: 'include',
         keywords: {
-          'meta-keyword': 'include'
+          keyword: 'include'
         },
         end: '$',
         contains: [
           STRING,
           {
-            className: 'meta-string',
+            className: 'string',
             variants: [
               {
                 begin: '<',

src/languages/c.js

@@ -82,7 +82,7 @@ export default function(hljs) {
     begin: /#\s*[a-z]+\b/,
     end: /$/,
     keywords: {
-      'meta-keyword':
+      keyword:
         'if else elif endif define undef warning error line ' +
         'pragma _Pragma ifdef ifndef include'
     },
@@ -92,10 +92,10 @@ export default function(hljs) {
         relevance: 0
       },
       hljs.inherit(STRINGS, {
-        className: 'meta-string'
+        className: 'string'
       }),
       {
-        className: 'meta-string',
+        className: 'string',
         begin: /<.*?>/
       },
       C_LINE_COMMENT_MODE,

src/languages/cpp.js

@@ -76,7 +76,7 @@ export default function(hljs) {
     begin: /#\s*[a-z]+\b/,
     end: /$/,
     keywords: {
-      'meta-keyword':
+      keyword:
         'if else elif endif define undef warning error line ' +
         'pragma _Pragma ifdef ifndef include'
     },
@@ -86,10 +86,10 @@ export default function(hljs) {
         relevance: 0
       },
       hljs.inherit(STRINGS, {
-        className: 'meta-string'
+        className: 'string'
       }),
       {
-        className: 'meta-string',
+        className: 'string',
         begin: /<.*?>/
       },
       C_LINE_COMMENT_MODE,

src/languages/crystal.js

@@ -207,7 +207,7 @@ export default function(hljs) {
     end: '\\]',
     contains: [
       hljs.inherit(hljs.QUOTE_STRING_MODE, {
-        className: 'meta-string'
+        className: 'string'
       })
     ]
   };

src/languages/csharp.js

@@ -329,7 +329,7 @@ export default function(hljs) {
         begin: '#',
         end: '$',
         keywords: {
-          'meta-keyword': 'if else elif endif define undef warning error line region endregion pragma checksum'
+          keyword: 'if else elif endif define undef warning error line region endregion pragma checksum'
         }
       },
       STRING,
@@ -381,7 +381,7 @@ export default function(hljs) {
         excludeEnd: true,
         contains: [
           {
-            className: 'meta-string',
+            className: 'string',
             begin: /"/,
             end: /"/
           }

src/languages/dts.js

@@ -45,7 +45,7 @@ export default function(hljs) {
     begin: '#',
     end: '$',
     keywords: {
-      'meta-keyword': 'if else elif endif define undef ifdef ifndef'
+      keyword: 'if else elif endif define undef ifdef ifndef'
     },
     contains: [
       {
@@ -56,14 +56,14 @@ export default function(hljs) {
         beginKeywords: 'include',
         end: '$',
         keywords: {
-          'meta-keyword': 'include'
+          keyword: 'include'
         },
         contains: [
           hljs.inherit(STRINGS, {
-            className: 'meta-string'
+            className: 'string'
           }),
           {
-            className: 'meta-string',
+            className: 'string',
             begin: '<',
             end: '>',
             illegal: '\\n'
@@ -82,7 +82,7 @@ export default function(hljs) {
   };
 
   const KEYWORD = {
-    className: 'meta',
+    className: 'keyword',
     begin: '/[a-z][a-z\\d-]*/'
   };
 

src/languages/gams.js

@@ -119,7 +119,7 @@ export default function(hljs) {
         returnBegin: true,
         contains: [
           {
-            className: 'meta-keyword',
+            className: 'keyword',
             begin: '^\\$[a-z0-9]+'
           }
         ]

src/languages/gauss.js

@@ -117,7 +117,7 @@ export default function(hljs) {
     begin: '#',
     end: '$',
     keywords: {
-      'meta-keyword': 'define definecs|10 undef ifdef ifndef iflight ifdllcall ifmac ifos2win ifunix else endif lineson linesoff srcfile srcline'
+      keyword: 'define definecs|10 undef ifdef ifndef iflight ifdllcall ifmac ifos2win ifunix else endif lineson linesoff srcfile srcline'
     },
     contains: [
       {
@@ -128,11 +128,11 @@ export default function(hljs) {
         beginKeywords: 'include',
         end: '$',
         keywords: {
-          'meta-keyword': 'include'
+          keyword: 'include'
         },
         contains: [
           {
-            className: 'meta-string',
+            className: 'string',
             begin: '"',
             end: '"',
             illegal: '\\n'

src/languages/haxe.js

@@ -58,7 +58,7 @@ export default function(hljs) {
         begin: '#',
         end: '$',
         keywords: {
-          'meta-keyword': 'if else elseif end error'
+          keyword: 'if else elseif end error'
         }
       },
       {

src/languages/hsp.js

@@ -37,11 +37,11 @@ export default function(hljs) {
         begin: '#',
         end: '$',
         keywords: {
-          'meta-keyword': 'addion cfunc cmd cmpopt comfunc const defcfunc deffunc define else endif enum epack func global if ifdef ifndef include modcfunc modfunc modinit modterm module pack packopt regcmd runtime undef usecom uselib'
+          keyword: 'addion cfunc cmd cmpopt comfunc const defcfunc deffunc define else endif enum epack func global if ifdef ifndef include modcfunc modfunc modinit modterm module pack packopt regcmd runtime undef usecom uselib'
         },
         contains: [
           hljs.inherit(hljs.QUOTE_STRING_MODE, {
-            className: 'meta-string'
+            className: 'string'
           }),
           hljs.NUMBER_MODE,
           hljs.C_NUMBER_MODE,

src/languages/kotlin.js

@@ -96,7 +96,7 @@ export default function(hljs) {
         end: /\)/,
         contains: [
           hljs.inherit(STRING, {
-            className: 'meta-string'
+            className: 'string'
           })
         ]
       }

src/languages/makefile.js

@@ -55,7 +55,7 @@ export default function(hljs) {
     end: /$/,
     keywords: {
       $pattern: /[\.\w]+/,
-      'meta-keyword': '.PHONY'
+      keyword: '.PHONY'
     }
   };
   /* Targets */

src/languages/monkey.js

@@ -68,7 +68,7 @@ export default function(hljs) {
         begin: '\\s*#',
         end: '$',
         keywords: {
-          'meta-keyword': 'if else elseif endif end then'
+          keyword: 'if else elseif endif end then'
         }
       },
       {

src/languages/objectivec.js

@@ -209,7 +209,7 @@ export default function(hljs) {
         begin: /#\s*[a-z]+\b/,
         end: /$/,
         keywords: {
-          'meta-keyword':
+          keyword:
             'if else elif endif define undef warning error line ' +
             'pragma ifdef ifndef include'
         },
@@ -219,10 +219,10 @@ export default function(hljs) {
             relevance: 0
           },
           hljs.inherit(hljs.QUOTE_STRING_MODE, {
-            className: 'meta-string'
+            className: 'string'
           }),
           {
-            className: 'meta-string',
+            className: 'string',
             begin: /<.*?>/,
             end: /$/,
             illegal: '\\n'

src/languages/openscad.js

@@ -26,7 +26,7 @@ export default function(hljs) {
   const PREPRO = {
     className: 'meta',
     keywords: {
-      'meta-keyword': 'include use'
+      keyword: 'include use'
     },
     begin: 'include|use <',
     end: '>'

src/languages/r.js

@@ -108,7 +108,7 @@ export default function(hljs) {
               begin: /@[a-zA-Z]+/
             },
             {
-              className: 'meta-keyword',
+              className: 'keyword',
               begin: /\\[a-zA-Z]+/,
             }
           ]

src/languages/rust.js

@@ -243,7 +243,7 @@ export default function(hljs) {
         end: '\\]',
         contains: [
           {
-            className: 'meta-string',
+            className: 'string',
             begin: /"/,
             end: /"/
           }

src/languages/sqf.js

@@ -2463,7 +2463,7 @@ export default function(hljs) {
     begin: /#\s*[a-z]+\b/,
     end: /$/,
     keywords: {
-      'meta-keyword':
+      keyword:
         'define undef ifdef ifndef else endif include'
     },
     contains: [
@@ -2472,10 +2472,10 @@ export default function(hljs) {
         relevance: 0
       },
       hljs.inherit(STRINGS, {
-        className: 'meta-string'
+        className: 'string'
       }),
       {
-        className: 'meta-string',
+        className: 'string',
         begin: /<[^\n>]*>/,
         end: /$/,
         illegal: '\\n'

src/languages/vbnet.js

@@ -125,7 +125,7 @@ export default function(hljs) {
     begin: /[\t ]*#(const|disable|else|elseif|enable|end|externalsource|if|region)\b/,
     end: /$/,
     keywords: {
-      'meta-keyword':
+      keyword:
         'const disable else elseif enable end externalsource if region then'
     },
     contains: [ COMMENT ]

src/languages/verilog.js

@@ -115,7 +115,7 @@ export default function(hljs) {
         begin: '`',
         end: '$',
         keywords: {
-          'meta-keyword':
+          keyword:
             'define __FILE__ ' +
             '__LINE__ begin_keywords celldefine default_nettype define ' +
             'else elsif end_keywords endcelldefine endif ifdef ifndef ' +