workshopsoft/ludic
2
0
Fork 0
Code Issues Pull requests Projects Releases 26 Packages Wiki Activity Actions

Phase 6a: rename core vocabulary (game/main/component/archetype/system)

Browse source 
game/module -> program, main -> entry, component -> property,
archetype -> model, system -> handler. Done via a transitional self-hosting
bootstrap: parser accepts both -> reseed -> compiler source moved to new
keywords + parser tightened to new-only -> reseed (fixpoint holds). Old keywords
now rejected.

Token-safe corpus migration (tools/ludic-tools/rename_kw.c) leaves the LLVM
@main/entry: labels in emit strings untouched; goldens byte-identical. Editor
vocab (header/JetBrains/TextMate/emacs), check-docs wrapper, and doc fences
updated; error string 'unknown component' -> 'unknown property'. test.sh 14/14,
test-tools 28/0, check-vocabulary green. (Doc prose pass to follow.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Orkun ÇAKILKAYA 2026-08-27 18:22:13 +03:00
parent 3227e1e1d3
commit 42f955fd22
35 changed files with 2632 additions and 2646 deletions
Download patch file Download diff file Expand all files Collapse all files

10
tools/check-docs.py
View file

@ -19,22 +19,22 @@ A bare fragment is wrapped first: a declaration list goes inside
import re, subprocess, sys, os, tempfile
LC = './build/ludicc'
DECL = ('game','module','component','archetype','system','edge','fn','pure',
'extern','const','var','ui','scene','import')
DECL = ('program','property','model','handler','enum','fn',
'extern','const','var','ui','struct','import')
def classify(body):
first = next((l.strip() for l in body.split('\n')
if l.strip() and not l.strip().startswith('#')), '')
head = first.split('(')[0].split()[0] if first else ''
if head in ('game','module'): return 'whole'
if head == 'program': return 'whole'
return 'decls' if head in DECL else 'stmts'
def wraps(body, kind):
"""Candidate framings, best guess first. An excerpt often mixes declarations
with loose statements, so both are tried and either parsing counts."""
if kind == 'whole': return [body]
as_decls = 'game DocCheck {\n' + body + '\n}\n'
as_stmts = 'game DocCheck {\n system DocS phase Start {\n' + body + '\n }\n}\n'
as_decls = 'program DocCheck {\n' + body + '\n}\n'
as_stmts = 'program DocCheck {\n handler DocS phase Start {\n' + body + '\n }\n}\n'
return [as_decls, as_stmts] if kind == 'decls' else [as_stmts, as_decls]
def fences(path):

4
tools/editors/emacs/ludic-mode.el
View file

@ -11,8 +11,8 @@
;;; Code:
(defconst ludic--declaration-keywords
'("game" "module" "import" "component" "struct" "archetype" "enum" "ui"
"const" "var" "fn" "extern" "system" "main"))
'("program" "import" "property" "struct" "model" "enum" "ui"
"const" "var" "fn" "extern" "handler" "entry"))
(defconst ludic--clause-keywords
'("phase" "query" "reads" "writes"))

4
tools/editors/jetbrains/src/main/kotlin/io/ludic/ide/LudicTokens.kt
View file

@ -41,8 +41,8 @@ object LudicTokens {
*/
object LudicVocabulary {
val DECL = setOf(
"game", "module", "import", "component", "struct", "archetype", "enum", "ui",
"const", "var", "fn", "extern", "system", "main"
"program", "import", "property", "struct", "model", "enum", "ui",
"const", "var", "fn", "extern", "handler", "entry"
)
val CLAUSE = setOf(
"phase", "query", "reads", "writes"

10
tools/editors/shared/ludic.tmLanguage.json
View file

@ -54,21 +54,21 @@
"declaration": {
"patterns": [
{
"match": "\\b(game|module)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(program)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "keyword.control.unit.ludic" },
"2": { "name": "entity.name.type.unit.ludic" }
}
},
{
"match": "\\b(component)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(property)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.component.ludic" },
"2": { "name": "entity.name.type.component.ludic" }
}
},
{
"match": "\\b(archetype)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(model)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.archetype.ludic" },
"2": { "name": "entity.name.type.archetype.ludic" }
@ -82,7 +82,7 @@
}
},
{
"match": "\\b(system)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(handler)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.system.ludic" },
"2": { "name": "entity.name.function.system.ludic" }
@ -165,7 +165,7 @@
{ "name": "keyword.operator.logical.ludic", "match": "\\b(and|or|not)\\b" },
{ "name": "keyword.other.clause.ludic", "match": "\\b(phase|query|reads|writes)\\b" },
{ "name": "keyword.other.ludic", "match": "\\b(import|extern)\\b" },
{ "name": "storage.type.ludic", "match": "\\b(game|module|component|struct|archetype|enum|ui|const|var|let|fn|system|main|state)\\b" },
{ "name": "storage.type.ludic", "match": "\\b(program|property|struct|model|enum|ui|const|var|let|fn|handler|entry|state)\\b" },
{ "name": "support.type.primitive.ludic", "match": "\\b(int|fixed|bool|entity|str|ptr|void)\\b" },
{ "name": "constant.language.boolean.ludic", "match": "\\b(true|false)\\b" },
{ "name": "constant.language.phase.ludic", "match": "\\b(Start|Input|FixedUpdate|Update|LateUpdate|Render)\\b" }

10
tools/editors/vscode/syntaxes/ludic.tmLanguage.json
View file

@ -54,21 +54,21 @@
"declaration": {
"patterns": [
{
"match": "\\b(game|module)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(program)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "keyword.control.unit.ludic" },
"2": { "name": "entity.name.type.unit.ludic" }
}
},
{
"match": "\\b(component)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(property)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.component.ludic" },
"2": { "name": "entity.name.type.component.ludic" }
}
},
{
"match": "\\b(archetype)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(model)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.archetype.ludic" },
"2": { "name": "entity.name.type.archetype.ludic" }
@ -82,7 +82,7 @@
}
},
{
"match": "\\b(system)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"match": "\\b(handler)\\s+([A-Za-z_][A-Za-z0-9_]*)",
"captures": {
"1": { "name": "storage.type.system.ludic" },
"2": { "name": "entity.name.function.system.ludic" }
@ -165,7 +165,7 @@
{ "name": "keyword.operator.logical.ludic", "match": "\\b(and|or|not)\\b" },
{ "name": "keyword.other.clause.ludic", "match": "\\b(phase|query|reads|writes)\\b" },
{ "name": "keyword.other.ludic", "match": "\\b(import|extern)\\b" },
{ "name": "storage.type.ludic", "match": "\\b(game|module|component|struct|archetype|enum|ui|const|var|let|fn|system|main|state)\\b" },
{ "name": "storage.type.ludic", "match": "\\b(program|property|struct|model|enum|ui|const|var|let|fn|handler|entry|state)\\b" },
{ "name": "support.type.primitive.ludic", "match": "\\b(int|fixed|bool|entity|str|ptr|void)\\b" },
{ "name": "constant.language.boolean.ludic", "match": "\\b(true|false)\\b" },
{ "name": "constant.language.phase.ludic", "match": "\\b(Start|Input|FixedUpdate|Update|LateUpdate|Render)\\b" }

4
tools/ludic-tools/ludic_syntax.h
View file

@ -52,8 +52,8 @@ typedef struct {
* mirror the compiler's parser: anything parse_decl() dispatches on is a
* declaration keyword, anything stmt() dispatches on is a statement keyword. */
static const char* LUDIC_KW_DECL[] = {
"game","module","import","component","struct","archetype","enum","ui",
"const","var","fn","extern","system","main", 0
"program","import","property","struct","model","enum","ui",
"const","var","fn","extern","handler","entry", 0
};
static const char* LUDIC_KW_CLAUSE[] = {
"phase","query","reads","writes", 0