pkl / PR 1821

Add pkl:syntax stdlib module

apple/pkl#1821 openmixed

+3327/−126lines

42files

85comments

2026-08-12opened

-merged

What it touches

test: 20 main: 19 other: 2 build: 1

Modules: pkl-core (31), pkl-parser (6), pkl-formatter (3), stdlib (2)

Architectural impact (arcade-agent `diff_impact`)

11files mapped to the graph

322entities in those files

Core, Formatter, Parsercomponents

2818entities within 3 hops downstream

Most depended-upon changed entities

Entity	Dependents
`org.pkl.core.runtime.VmUtils`	522
`org.pkl.core.runtime.Identifier`	308
`org.pkl.parser.syntax.generic.Node.Node`	214
`org.pkl.formatter.Formatter.Formatter`	40
`org.pkl.formatter.Builder.Builder`	16
`org.pkl.formatter.Builder.nodes`	4

Computed against the current default branch, not the PR base commit; files renamed or deleted since then are unmatched. Downstream counts are a reverse-dependency closure to depth 3 and over-approximate real blast radius.

Build & CI relevance

Touches Gradle/build files: review for build-time or cache impact.

Files

build	`pkl-core/pkl-core.gradle.kts`
main	`pkl-core/src/main/java/org/pkl/core/runtime/Identifier.java`
main	`pkl-core/src/main/java/org/pkl/core/runtime/MirrorFactories.java`
main	`pkl-core/src/main/java/org/pkl/core/runtime/ModuleCache.java`
main	`pkl-core/src/main/java/org/pkl/core/runtime/ReflectModule.java`
main	`pkl-core/src/main/java/org/pkl/core/runtime/SyntaxModule.java`
main	`pkl-core/src/main/java/org/pkl/core/runtime/VmUtils.java`
main	`pkl-core/src/main/java/org/pkl/core/stdlib/syntax/FormattingRendererNodes.java`
main	`pkl-core/src/main/java/org/pkl/core/stdlib/syntax/GenericNodeNodes.java`
main	`pkl-core/src/main/java/org/pkl/core/stdlib/syntax/ParserNodes.java`
main	`pkl-core/src/main/java/org/pkl/core/stdlib/syntax/SyntaxNodes.java`
main	`pkl-core/src/main/java/org/pkl/core/stdlib/syntax/package-info.java`
main	`pkl-core/src/main/resources/org/pkl/core/errorMessages.properties`
test	`pkl-core/src/test/files/LanguageSnippetTests/input-helper/syntax/spans/sample.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/errors/syntaxParseExpression.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/errors/syntaxParseModule.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/query.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/render.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/spans.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/transform.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/transformTree.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/input/syntax/traversal.pkl`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/errors/cannotFindStdLibModule.err`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/errors/syntaxParseExpression.err`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/errors/syntaxParseModule.err`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/query.pcf`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/render.pcf`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/spans.pcf`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/transform.pcf`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/transformTree.pcf`
test	`pkl-core/src/test/files/LanguageSnippetTests/output/syntax/traversal.pcf`
main	`pkl-formatter/src/main/java/org/pkl/formatter/Builder.java`
main	`pkl-formatter/src/main/java/org/pkl/formatter/Formatter.java`
test	`pkl-formatter/src/test/kotlin/org/pkl/formatter/FormatterTest.kt`
main	`pkl-parser/src/main/java/org/pkl/parser/GenericParser.java`
main	`pkl-parser/src/main/java/org/pkl/parser/GenericParserImpl.java`
main	`pkl-parser/src/main/java/org/pkl/parser/syntax/generic/FullSpan.java`
main	`pkl-parser/src/main/java/org/pkl/parser/syntax/generic/Node.java`
main	`pkl-parser/src/main/java/org/pkl/parser/syntax/generic/NodeType.java`
test	`pkl-parser/src/test/kotlin/org/pkl/parser/GenericSexpRenderer.kt`
other	`stdlib/reflect.pkl`
other	`stdlib/syntax.pkl`