sile 0.15.11

Simon’s Improved Layout Engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

local epnf = require("epnf")
local bits = require("core.parserbits")

local passthroughCommands = {
   ftl = true,
   lua = true,
   math = true,
   raw = true,
   script = true,
   sil = true,
   use = true,
   xml = true,
}

local isPassthrough = function (_, _, command)
   return passthroughCommands[command] or false
end

local isNotPassthrough = function (...)
   return not isPassthrough(...)
end

local isMatchingEndEnv = function (_, _, thisCommand, lastCommand)
   return thisCommand == lastCommand
end

-- luacheck: push ignore
-- stylua: ignore start
---@diagnostic disable: undefined-global, unused-local, lowercase-global
local function builder (_ENV)
   local eol = S"\r\n"
   local specials = S"\\{}%"
   local escaped_specials = P"\\" * specials
   local unescapeSpecials = function (str)
      return str:gsub('\\([{}%%\\])', '%1')
   end
   local myID = C(bits.silidentifier) / 1
   local cmdID = myID - P"begin" - P"end"
   local wrapper = function (a) return type(a)=="table" and a or {} end
   local parameters = (P"[" * bits.parameters * P"]")^-1 / wrapper

   local pass_end =
         P"\\end{" *
         ( cmdID * Cb"command" ) *
         ( P"}" ) + E"Environment begun but never ended"
   local notpass_end =
         P"\\end{" *
         ( Cmt(cmdID * Cb"command", isMatchingEndEnv) + E"Environment mismatch") *
         ( P"}" ) + E"Environment begun but never ended"

   env_passthrough_content = Cg(
         V"env_passthrough_text"
      )^0
   env_passthrough_text = C((1 - (P"\\end{" * Cmt(cmdID * Cb"command", isMatchingEndEnv) * P"}"))^1)
   passthrough_content = C(Cg(
         V"passthrough_text" +
         V"debraced_passthrough_text"
      )^0)
   passthrough_text = C((1-S("{}"))^1)
   debraced_passthrough_text = C(V"braced_passthrough_text")
   braced_passthrough_text = P"{" * V"passthrough_content" * ( P"}" + E("} expected") )

   START"document"
   document = V"content" * EOF"Unexpected character at end of input"
   content = Cg(
         V"environment" +
         V"comment" +
         V"text" +
         V"braced_content" +
         V"command"
      )^0
   environment =
      P"\\begin" *
      Cg(parameters, "options") *
      P"{" *
      Cg(cmdID, "command") *
      P"}" *
      (
         (Cmt(Cb"command", isPassthrough) * V"env_passthrough_content" * pass_end) +
         (Cmt(Cb"command", isNotPassthrough) * V"content" * notpass_end)
      )
   comment = C( P"%" * P(1-eol)^0 * eol^-1 / "" )
   text = C((1 - specials + escaped_specials)^1) / unescapeSpecials
   braced_content = P"{" * V"content" * ( P"}" + E("} expected") )
   command = (
         P"\\" *
         Cg(cmdID, "command") *
         Cg(parameters, "options") *
         (
         (Cmt(Cb"command", isPassthrough) * V"braced_passthrough_text") +
         (Cmt(Cb"command", isNotPassthrough) * V"braced_content")
         )^0
      )
end
-- luacheck: pop
-- stylua: ignore end
---@diagnostic enable: undefined-global, unused-local, lowercase-global

local grammar = epnf.define(builder)

local function parser (string)
   return epnf.parsestring(grammar, string)
end

return parser