teal-language/tl

View on GitHub

The compiler for Teal, a typed dialect of Lua

Stars: 2.8k
Forks: 163
Open beginner issues: 0
Indexed issues: 128
Avg merge: 16h 58m
Merged PRs (30d): 5

Dominant language: Lua
License: MIT
Last GitHub push: Sep 15, 2026
Latest indexed: Sep 19, 2026
Contributing guide: No contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

128 open issues indexed

Let's add some LuaJIT syntax extensions Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 30/100

teal-language/tl#1153 · 3 comments · 1 reaction · Opened Jul 29, 2026
Built-in types can be inherited from, but that results in strange semantics Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 65/100

teal-language/tl#1152 · 3 comments · Opened Jul 25, 2026
The type of `self` in metamethods is not checked Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 64/100

teal-language/tl#1151 · Opened Jul 25, 2026
New feature: string interpolation Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 45/100

teal-language/tl#1145 · 1 comment · 1 reaction · Opened Jul 16, 2026
Teal doesn't inject `compat53` when `math.type` is used implicitly on a `nil` value Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 65/100

teal-language/tl#1144 · Opened Jul 14, 2026
Why are nested records of type metatable<T>, while top-level records are not? Open

bug semantics

Difficulty 3/5 1-2 days Newbie friendliness 48/100

teal-language/tl#1141 · 1 comment · Opened Jul 11, 2026
Type not equal to itself after circular require. Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1140 · 5 comments · Opened Jul 8, 2026
How to extend known global records? Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

teal-language/tl#1138 · 20 comments · Opened Jul 5, 2026
macroexp methods on union types are miscompiled Open

bug semantics

Difficulty 3/5 1-2 days Newbie friendliness 55/100

teal-language/tl#1134 · 3 comments · Opened Jun 17, 2026
Ambgious grammar for locals named record/interface/... Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1132 · 1 comment · Opened Jun 17, 2026
Redeclaring a `global` type alias crashes the compiler Open

Difficulty 3/5 1-2 days Newbie friendliness 65/100

teal-language/tl#1126 · Opened May 30, 2026
wrong spacing when using macro expressions to create and run functions. Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1117 · 2 comments · Opened Apr 30, 2026
macro expression recursion mis compilation Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

teal-language/tl#1116 · Opened Apr 30, 2026
Generic constraints not being checked in some places Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

teal-language/tl#1115 · 1 comment · 1 reaction · Opened Apr 18, 2026
Warnings should probably not be reported in `require`d files Open

feature request

Difficulty 4/5 3-5 days Newbie friendliness 48/100

teal-language/tl#1114 · Opened Apr 17, 2026
Variadic type parameters Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 25/100

teal-language/tl#1112 · 1 comment · 1 reaction · Opened Mar 31, 2026
For projects with non-default source_dir, tl requires include_dir to be set and cyan complains if include_dir is set Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

teal-language/tl#1111 · 1 comment · Opened Mar 30, 2026
interface can extend itself and other possible oddities. Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 42/100

teal-language/tl#1110 · 1 comment · 1 reaction · Opened Mar 29, 2026
Add variable names to tl types command Open

feature request

Difficulty 3/5 1-2 days Newbie friendliness 55/100

teal-language/tl#1109 · 1 reaction · Opened Mar 29, 2026
misleading error messages when calling function without return type as param Open

semantics

Difficulty 3/5 1-2 days Newbie friendliness 55/100

teal-language/tl#1108 · 5 comments · Opened Mar 26, 2026
First line is somewhat special. Maybe it should be treated as such? Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1107 · Opened Mar 25, 2026
macroexprs on enums Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 25/100

teal-language/tl#1067 · 6 comments · Opened Jan 12, 2026
Simple constants as types Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1064 · 4 comments · 1 reaction · Opened Jan 8, 2026
Contextual typing / target type inference Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1062 · 4 comments · 3 reactions · Opened Jan 8, 2026
ts-style ignore or any for flexibility Open

feature request semantics

Difficulty 5/5 Over a week Newbie friendliness 25/100

teal-language/tl#1054 · 1 comment · Opened Dec 4, 2025
Generic's type is always assumed to be a table even when it isn't Open

bug semantics

Difficulty 3/5 1-2 days Newbie friendliness 45/100

teal-language/tl#1053 · 2 comments · Opened Nov 30, 2025
Feature request: a new mode to make teal compiler a running service with cache mechanism Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1046 · 6 comments · 1 reaction · Opened Nov 6, 2025
Feature request: add more info in `TypeInfo` and `TypeReport` Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1045 · 2 comments · 2 reactions · Opened Nov 6, 2025
Union between 2 tables of the same interface should be able to be indexed Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1042 · 4 comments · 1 reaction · Opened Oct 21, 2025
Support functions being named the same as types Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1033 · 1 comment · Opened Sep 26, 2025
Support declaration merging for global records Open

bug feature request

Difficulty 4/5 3-5 days Newbie friendliness 38/100

teal-language/tl#1032 · 1 comment · Opened Sep 26, 2025
Constructing untyped tables throws unnecessary "cannot discriminate a union between multiple table types" Open

semantics

Difficulty 3/5 1-2 days Newbie friendliness 45/100

teal-language/tl#1026 · 2 comments · Opened Aug 17, 2025
Compiler option to warn when non-boolean values used in if statements Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#1014 · 2 comments · Opened Jul 4, 2025
Teal should give a hint about using `local type` for `require` Open

feature request

Difficulty 4/5 3-5 days Newbie friendliness 38/100

teal-language/tl#1013 · 1 comment · 1 reaction · Opened Jul 3, 2025
Unable to extend the methods of string type Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

teal-language/tl#1004 · 1 comment · Opened Jun 6, 2025
Cannot index a SomeType | nil even when using and to check for nil Open

nil semantics

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#1000 · 1 comment · 1 reaction · Opened May 31, 2025
Integer doesn't behave as a subtype of number when used inside generic signatures - "got integer, expected number" Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 35/100

teal-language/tl#989 · 1 comment · Opened May 20, 2025
Cannot use semicolon after return statement Open

bug good first issue

Difficulty 3/5 1-2 days Newbie friendliness 45/100

teal-language/tl#976 · 10 comments · Opened May 13, 2025
Allow record fields to have pre-initialized value. Open

feature request

Difficulty 4/5 3-5 days Newbie friendliness 42/100

teal-language/tl#971 · 9 comments · 2 reactions · Opened May 11, 2025
Generics inference issue: "an explicit type annotation is necessary" Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 35/100

teal-language/tl#968 · 1 comment · Opened May 9, 2025
bad inferred type with `next` Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#966 · Opened May 6, 2025
Extended BNF grammar is outdated with current syntax of Teal Open

docs

Difficulty 3/5 1-2 days Newbie friendliness 35/100

teal-language/tl#952 · 1 comment · Opened Apr 22, 2025
Documentation for types command Open

docs feature request

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

teal-language/tl#949 · 6 comments · Opened Apr 14, 2025
Proposal: Support for self-assignment operators (+=, -=, *=, /=) Open

feature request

Difficulty 5/5 Over a week Newbie friendliness 35/100

teal-language/tl#937 · 7 comments · 2 reactions · Opened Mar 20, 2025
Cannot access nested types in a circular type require Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

teal-language/tl#932 · 2 comments · Opened Mar 2, 2025
Types that are returned are included in compiled code Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 45/100

teal-language/tl#930 · 1 comment · Opened Feb 16, 2025
Bug: in some cases teal compiler cannot catch assign `interface` to `record` error. Open

semantics

Difficulty 4/5 3-5 days Newbie friendliness 45/100

teal-language/tl#925 · 4 comments · Opened Feb 1, 2025
tl.symbols_in_scope does not return correct type info in cases where it changes via assert Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

teal-language/tl#921 · 4 comments · Opened Jan 27, 2025
Type identifying where clause doesn't work when concrete type is provided as a generic argument Open

good first issue semantics

teal-language/tl#920 · 6 comments · 1 assignee · Opened Jan 26, 2025
Feature request: preserve comments data in type info Open

feature request

Difficulty 4/5 3-5 days Newbie friendliness 35/100

teal-language/tl#907 · 5 comments · Opened Jan 13, 2025

teal-language/tl

Get new issues in your inbox