ci(primitives): transition to new css primitives

GitHub no longer distributes primitives in JSON format. Also, the names
of the values (CSS variables) have changed. Most of the new names
correspond 1-to-1 with one of the old names. Some colors have also
changed slightly (e.g. `fg-default`), but otherwise remain mostly the
same.

See https://primer.style/foundations/primitives/migrating

Author: tmillr

.github/workflows/csstolua.lua

@@ -0,0 +1,132 @@
+local res = {}
+
+local function is_valid_ident(ident)
+  local keyword = {
+    ['do'] = true,
+    ['end'] = true,
+    ['if'] = true,
+    ['then'] = true,
+    ['local'] = true,
+    ['function'] = true,
+    ['return'] = true,
+    ['while'] = true,
+    ['repeat'] = true,
+    ['until'] = true,
+    ['for'] = true,
+    ['in'] = true,
+    ['true'] = true,
+    ['false'] = true,
+    ['nil'] = true,
+  }
+
+  if type(ident) ~= 'string' or keyword[ident] then
+    return false
+  end
+
+  return ident:find('^[_%a][_%w]*$') ~= nil
+end
+
+local function set(cssvar, v)
+  local before, last = cssvar:match('^(.+)%-+(.+)$')
+
+  -- Top-level key
+  if not last then
+    res[tonumber(cssvar) or cssvar] = v
+    return
+  end
+
+  last = tonumber(last) or last
+  local cur = res
+  for k in before:gmatch('[^%-_]+') do
+    k = tonumber(k) or k
+    cur[k] = cur[k] or {}
+    cur = cur[k]
+  end
+
+  -- Path is too short: append `default`
+  if type(cur[last]) == 'table' then
+    cur, last = cur[last], 'default'
+  end
+
+  -- Check duplicates
+  assert(cur[last] == nil or cur[last] == v)
+
+  cur[last] = v
+end
+
+local function print_recur(value, _ind)
+  _ind = _ind or 0
+
+  if type(value) == 'table' then
+    io.write('m {')
+    _ind = _ind + 2
+
+    for k, v in pairs(value) do
+      local fmt = '[%q] = '
+      if type(k) == 'number' then
+        fmt = '[%s] = '
+      elseif is_valid_ident(k) then
+        fmt = '%s = '
+      end
+      io.write(('\n%s' .. fmt):format((' '):rep(_ind), k))
+      print_recur(v, _ind)
+      io.write(',')
+    end
+
+    _ind = _ind - 2
+    io.write(('\n%s}'):format((' '):rep(_ind)))
+  else
+    io.write(('%q'):format(value))
+  end
+end
+
+local defs = {}
+for ln in io.lines() do
+  local k, v = ln:match('^%s*%-%-(%w.-)%s*:%s*(.-)%s*;%s*$')
+  if k then
+    table.insert(defs, { k, v })
+  end
+end
+
+-- Since we are un-flattening, ensure that longer keys (whose prefix could
+-- match another key) are visited first.
+table.sort(defs, function(a, b)
+  return a[1] > b[1]
+end)
+
+for _, kv in ipairs(defs) do
+  set(unpack(kv))
+end
+
+-- Add `scale` key for convenience and backwards-compatibility
+assert(res.scale == nil)
+res.scale = {}
+for color, scale in pairs(res.base.color) do
+  if type(scale) == 'table' then
+    res.scale[color] = {}
+    for i, v in pairs(scale) do
+      res.scale[color][i + 1] = v
+    end
+  else
+    res.scale[color] = scale
+  end
+end
+
+-- NOTE: the metatable `mt` helps to catch errors (e.g. during CI tests)
+io.write([=[
+local mt = {
+  __index = function(_, k)
+    error('invalid index: ' .. k)
+  end,
+}
+---@generic T
+---@param tbl T
+---@return T
+local function m(tbl)
+  return setmetatable(tbl, mt)
+end
+local M = ]=])
+
+print_recur(res)
+
+io.write('\n')

.github/workflows/update-color-primitives.yml

@@ -1,19 +1,20 @@
-name: Get/Update Primer Color Primitives
+name: Get/Update Primer Primitives
 
 env:
   _DEST_DIR: "${{ github.workspace }}/lua/github-theme/palette/primitives"
-  _JSON_DIR: "${{ github.workspace }}/node_modules/@primer/primitives/dist/json/colors"
+  _SRC_DIR: "${{ github.workspace }}/node_modules/@primer/primitives/dist/internalCss"
   _LICENSE_GLOB: "${{ github.workspace }}/node_modules/@primer/primitives/[Ll][Ii][Cc][Ee][Nn][Ss][Ee]*"
   _PRIMITIVES_PKGJSON: "${{ github.workspace }}/node_modules/@primer/primitives/package.json"
+  _CSSTOLUA: "${{ github.workspace }}/.github/workflows/csstolua.lua"
 
 on:
   workflow_dispatch:
   schedule:
-    # 3x per week (every other day) at 12:40pm Pacific Time
-    - cron: "40 19 * * 1,3,5"
+    # once a week, every Monday at 12:40pm Pacific Time
+    - cron: "40 19 * * 1"
 
 jobs:
-  get-colors:
+  install-primitives:
     runs-on: ubuntu-latest
     permissions:
       checks: write
@@ -25,6 +26,9 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
+      - uses: rhysd/action-setup-vim@v1
+        with:
+          neovim: true
 
       - uses: actions/setup-node@v4
         with:
@@ -34,21 +38,22 @@ jobs:
       - run: npm i @primer/primitives@latest
 
       - run: |
-          set -u +f
+          set -eu +f
           shopt -s nocaseglob failglob
           license="$(<$_LICENSE_GLOB)"
           rm -r "$_DEST_DIR" || :
           mkdir -p "$_DEST_DIR"
-          cd "$_JSON_DIR"
+          cd "$_SRC_DIR"
 
           if jq -e .version "$_PRIMITIVES_PKGJSON"; then
             version="M._VERSION = vim.json.decode([=[$(jq -e .version "$_PRIMITIVES_PKGJSON")]=], { luanil = { object = false, array = false } })"
           fi
 
-          for file in *.json; do
-            cat >|"${_DEST_DIR}/${file%.json}.lua" <<EOF
+          for file in *.css; do
+            values="$(nvim -l "$_CSSTOLUA" < "$file")"
+            cat >| "${_DEST_DIR}/$(tr '-' '_' <<< "${file%.css}.lua")" <<EOF
           -- NOTE: THIS IS AN AUTO-GENERATED FILE. DO NOT EDIT BY-HAND.
-          local M = vim.json.decode([=[$(<"$file")]=], { luanil = { object = false, array = false } })
+          ${values}
           ${version-}
           M._LICENSE = [=[
           $license]=]

lua/github-theme/group/modules/treesitter.lua

@@ -10,7 +10,7 @@ function M.get(spec, config, opts)
         :gsub('^github_(.-)$', '%1')
   )
 
-  local pl = primitives.prettylights
+  local pl = primitives.color.prettylights
   local syn = spec.syntax
   local stl = config.styles
   local P = spec.palette

lua/github-theme/palette/github_dark.lua

@@ -8,12 +8,12 @@ local meta = {
 local primitives =
   require('github-theme.palette.primitives.' .. meta.name:gsub('^github%W*', '', 1))
 
-local pl = primitives.prettylights
+local pl = primitives.color.prettylights
 local scale = primitives.scale
 
 C.WHITE = C(scale.white)
 C.BLACK = C(scale.black)
-C.BG = C(scale.gray[7])
+C.BG = C(scale.neutral[7])
 
 local function alpha(color, a)
   return color:alpha_blend(a):to_css()
@@ -24,40 +24,40 @@ local palette = {
 
   orange = scale.orange[4],
 
-  black = { base = scale.gray[10], bright = scale.gray[9] },
-  gray = { base = scale.gray[5], bright = scale.gray[5] },
+  black = { base = scale.neutral[10], bright = scale.neutral[9] },
+  gray = { base = scale.neutral[5], bright = scale.neutral[5] },
   blue = { base = scale.blue[4], bright = scale.blue[3] },
   green = { base = scale.green[4], bright = scale.green[3] },
   magenta = { base = scale.purple[4], bright = scale.purple[3] },
   pink = { base = scale.pink[4], bright = scale.pink[3] },
   red = { base = scale.red[4], bright = scale.red[3] },
-  white = { base = scale.gray[3], bright = scale.gray[3] },
+  white = { base = scale.neutral[3], bright = scale.neutral[3] },
   yellow = { base = scale.yellow[4], bright = scale.yellow[3] },
   cyan = { base = '#76e3ea', bright = '#b3f0ff' },
 
   fg = {
     default = '#e6edf3',
     muted = '#7d8590',
-    subtle = scale.gray[5],
+    subtle = scale.neutral[5],
     on_emphasis = scale.white,
   },
 
   canvas = {
-    default = scale.gray[7],
-    overlay = scale.gray[9],
-    inset = scale.gray[8],
-    subtle = scale.gray[9],
+    default = scale.neutral[7],
+    overlay = scale.neutral[9],
+    inset = scale.neutral[8],
+    subtle = scale.neutral[9],
   },
 
   border = {
-    default = scale.gray[9],
-    muted = scale.gray[8],
+    default = scale.neutral[9],
+    muted = scale.neutral[8],
     subtle = alpha(C.from_rgba(240, 246, 252, 1), 0.1),
   },
 
   neutral = {
-    emphasis_plus = scale.gray[5],
-    emphasis = scale.gray[5],
+    emphasis_plus = scale.neutral[5],
+    emphasis = scale.neutral[5],
     muted = alpha(C.from_rgba(110, 118, 129, 1), 0.4),
     subtle = alpha(C.from_rgba(110, 118, 129, 1), 0.1),
   },
@@ -129,16 +129,16 @@ local palette = {
 local function generate_spec(pal)
   -- stylua: ignore start
   local spec = {
-    bg0  = alpha(C(pal.canvas.inset), 0.75),            -- Dark bg (popup and float)
-    bg1  = pal.canvas.default,                          -- Default bg
+    bg0  = alpha(C(primitives.bgColor.inset), 0.75),            -- Dark bg (popup and float)
+    bg1  = primitives.bgColor.default,                          -- Default bg
     bg2  = alpha(C(pal.neutral.emphasis), 0.1),         -- Lighter bg (colorcolumn Folds)
-    bg3  = pal.scale.gray[6],                           -- Lighter bg (cursor line)
-    bg4  = pal.scale.gray[4],                           -- Conceal
+    bg3  = pal.scale.neutral[6],                           -- Lighter bg (cursor line)
+    bg4  = pal.scale.neutral[4],                           -- Conceal
 
     fg0  = pal.fg.subtle,                               -- Lighter fg
-    fg1  = pal.fg.default,                              -- Default fg
+    fg1  = primitives.fgColor.default,                              -- Default fg
     fg2  = pal.fg.muted,                                -- Darker fg (status line)
-    fg3  = pal.scale.gray[5],                           -- Darker fg (line numbers, fold columns)
+    fg3  = pal.scale.neutral[5],                           -- Darker fg (line numbers, fold columns)
 
     sel0 = alpha(C(pal.accent.fg), 0.30),               -- Visual selection bg
     sel1 = alpha(C(pal.accent.muted), 0.90),            -- Popup sel bg
@@ -147,26 +147,26 @@ local function generate_spec(pal)
 
   spec.syntax = {
     bracket     = spec.fg1,                             -- Brackets and Punctuation
-    builtin0    = pl.syntax.constant,                   -- Builtin variable
+    builtin0    = pl.syntax.constant.default,                   -- Builtin variable
     builtin1    = pl.syntax.keyword,                    -- Builtin type
-    builtin2    = pl.syntax.constant,                   -- Builtin const
+    builtin2    = pl.syntax.constant.default,                   -- Builtin const
     comment     = pl.syntax.comment,                    -- Comment
     conditional = pl.syntax.keyword,                    -- Conditional and loop
-    const       = pl.syntax.constant,                   -- Constants, imports and booleans
+    const       = pl.syntax.constant.default,                   -- Constants, imports and booleans
     dep         = pal.scale.red[3],                     -- Deprecated
-    field       = pl.syntax.constant,                   -- Field
-    func        = pl.syntax.entity,                     -- Functions and Titles
+    field       = pl.syntax.constant.default,                   -- Field
+    func        = pl.syntax.entity.default,                     -- Functions and Titles
     ident       = spec.fg1,                             -- Identifiers
     keyword     = pl.syntax.keyword,                    -- Keywords
-    number      = pl.syntax.constant,                   -- Numbers
-    operator    = pl.syntax.constant,                   -- Operators
+    number      = pl.syntax.constant.default,                   -- Numbers
+    operator    = pl.syntax.constant.default,                   -- Operators
     param       = spec.fg1,                             -- Parameters
     preproc     = pl.syntax.keyword,                    -- PreProc
-    regex       = pl.syntax.string,                     -- Regex
+    regex       = pl.syntax.string.default,                     -- Regex
     statement   = pl.syntax.keyword,                    -- Statements
-    string      = pl.syntax.string,                     -- Strings
+    string      = pl.syntax.string.default,                     -- Strings
     type        = pl.syntax.variable,                   -- Types
-    tag         = pl.syntax.entityTag,                  -- Tags
+    tag         = pl.syntax.entity.tag,                  -- Tags
     variable    = spec.fg1,                             -- Variables
   }