change compile to implementation on groovy side

Co-authored-by: Stefan M. <StefMa@users.noreply.github.com>

.circleci/config.pkl

@@ -14,14 +14,16 @@
 // limitations under the License.
 //===----------------------------------------------------------------------===// 
 // File gets rendered to .circleci/config.yml via git hook.
-amends ".../pkl-project-commons/packages/pkl.impl.circleci/PklCI.pkl"
+amends "package://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.circleci@1.1.0#/PklCI.pkl"
 
 import "jobs/BuildNativeJob.pkl"
 import "jobs/GradleCheckJob.pkl"
 import "jobs/DeployJob.pkl"
 import "jobs/SimpleGradleJob.pkl"
 
-local prbJobs: Listing<String> = gradleCheckJobs.keys.toListing()
+local prbJobs: Listing<String> = (gradleCheckJobs.keys.toListing()) {
+  "check-patch-file"
+}
 
 local buildAndTestJobs = (prbJobs) {
   "bench"
@@ -51,6 +53,44 @@ main {
   }
 }
 
+// TODO: remove me once policy allows these jobs without approval
+circleCi {
+  workflows {
+    ["release-branch"] {
+      jobs = new Listing<*Mapping<String, WorkflowJob>|String> {
+        new {
+          ["hold"] {
+            type = "approval"
+          }
+        }
+        new {
+          ["pr-approval/authenticate"] {
+            context = "pkl-pr-approval"
+          }
+        }
+        for (job in super.jobs) {
+          job |> requireApproval
+        }
+      }
+    }
+  }
+}
+
+// TODO: remove me once policy allows these jobs without approval
+local requireApproval = (it: String|Mapping<String, WorkflowJob>) ->
+  if (it is String)
+    new Mapping<String, WorkflowJob> {
+      [it] {
+        requires { "hold" }
+      }
+    }
+  else
+    (it) {
+      [it.keys.first] {
+        requires { "hold" }
+      }
+    }
+
 release {
   jobs {
     ...releaseJobs
@@ -71,6 +111,10 @@ release {
   }
 }
 
+releaseBranch {
+  jobs = releaseJobs
+}
+
 triggerDocsBuild = "both"
 
 triggerPackageDocsBuild = "release"
@@ -122,24 +166,22 @@ jobs {
         :pkl-gradle:compatibilityTestCandidate
       """#
   }.job
-  ["deploy-snapshot"] = new DeployJob {
+  ["deploy-snapshot"] = new DeployJob { command = "publishToSonatype" }.job
-    command = "publishToSonatype"
-  }.job
   ["deploy-release"] = new DeployJob {
     isRelease = true
     command = "publishToSonatype closeAndReleaseSonatypeStagingRepository"
   }.job
   ["github-release"] {
     docker {
-      new {
+      new { image = "maniator/gh:v2.40.1" }
-        image = "maniator/gh:v2.40.1"
-      }
     }
     steps {
       new AttachWorkspaceStep { at = "." }
       new RunStep {
         name = "Publish release on GitHub"
         command = #"""
+          # exclude build_artifacts.txt from publish
+          rm pkl-cli/build/executable/*.build_artifacts.txt
           gh release create "${CIRCLE_TAG}" \
             --title "${CIRCLE_TAG}" \
             --target "${CIRCLE_SHA1}" \
@@ -151,4 +193,19 @@ jobs {
       }
     }
   }
+  ["check-patch-file"] {
+    docker {
+      new { image = "cimg/base:current" }
+    }
+    steps {
+      "checkout"
+      new RunStep {
+        // language=bash
+        command = #"""
+        git apply --reject patches/graalVm23.patch
+        """#
+      }
+    }
+    resource_class = "small"
+  }
 }

.circleci/config.yml

@@ -661,6 +661,10 @@ jobs:
         at: '.'
     - run:
         command: ./gradlew --info --stacktrace publishToSonatype
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
     - run:
         command: |-
           mkdir ~/test-results/
@@ -680,6 +684,10 @@ jobs:
         at: '.'
     - run:
         command: ./gradlew --info --stacktrace -DreleaseBuild=true publishToSonatype closeAndReleaseSonatypeStagingRepository
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
     - run:
         command: |-
           mkdir ~/test-results/
@@ -698,6 +706,8 @@ jobs:
         at: '.'
     - run:
         command: |-
+          # exclude build_artifacts.txt from publish
+          rm pkl-cli/build/executable/*.build_artifacts.txt
           gh release create "${CIRCLE_TAG}" \
             --title "${CIRCLE_TAG}" \
             --target "${CIRCLE_SHA1}" \
@@ -708,6 +718,14 @@ jobs:
         name: Publish release on GitHub
     docker:
     - image: maniator/gh:v2.40.1
+  check-patch-file:
+    steps:
+    - checkout
+    - run:
+        command: git apply --reject patches/graalVm23.patch
+    resource_class: small
+    docker:
+    - image: cimg/base:current
   trigger-docsite-build:
     steps:
     - run:
@@ -744,11 +762,12 @@ workflows:
     - gradle-check-jdk11:
         requires:
         - hold
-        - pr-approval/authenticate
     - gradle-check-jdk17:
         requires:
         - hold
-        - pr-approval/authenticate
+    - check-patch-file:
+        requires:
+        - hold
     when:
       matches:
         value: << pipeline.git.branch >>
@@ -757,6 +776,7 @@ workflows:
     jobs:
     - gradle-check-jdk11
     - gradle-check-jdk17
+    - check-patch-file
     - bench
     - pkl-cli-macOS-amd64-snapshot
     - pkl-cli-linux-amd64-snapshot
@@ -767,6 +787,7 @@ workflows:
         requires:
         - gradle-check-jdk11
         - gradle-check-jdk17
+        - check-patch-file
         - bench
         - pkl-cli-macOS-amd64-snapshot
         - pkl-cli-linux-amd64-snapshot
@@ -797,6 +818,12 @@ workflows:
             ignore: /.*/
           tags:
             only: /^v?\d+\.\d+\.\d+$/
+    - check-patch-file:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
     - bench:
         filters:
           branches:
@@ -837,6 +864,7 @@ workflows:
         requires:
         - gradle-check-jdk11
         - gradle-check-jdk17
+        - check-patch-file
         - bench
         - pkl-cli-macOS-amd64-release
         - pkl-cli-linux-amd64-release
@@ -868,3 +896,40 @@ workflows:
             ignore: /.*/
           tags:
             only: /^v?\d+\.\d+\.\d+$/
+  release-branch:
+    jobs:
+    - hold:
+        type: approval
+    - pr-approval/authenticate:
+        context: pkl-pr-approval
+    - gradle-check-jdk11:
+        requires:
+        - hold
+    - gradle-check-jdk17:
+        requires:
+        - hold
+    - check-patch-file:
+        requires:
+        - hold
+    - bench:
+        requires:
+        - hold
+    - pkl-cli-macOS-amd64-release:
+        requires:
+        - hold
+    - pkl-cli-linux-amd64-release:
+        requires:
+        - hold
+    - pkl-cli-macOS-aarch64-release:
+        requires:
+        - hold
+    - pkl-cli-linux-aarch64-release:
+        requires:
+        - hold
+    - pkl-cli-linux-alpine-amd64-release:
+        requires:
+        - hold
+    when:
+      matches:
+        value: << pipeline.git.branch >>
+        pattern: ^release/\d+\.\d+$

.circleci/jobs/BuildNativeJob.pkl

@@ -16,9 +16,8 @@
 /// Builds the native `pkl` CLI
 extends "GradleJob.pkl"
 
-// TODO(oss) replace these with package imports
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.0#/Config.pkl"
-import ".../pkl-pantry/packages/com.circleci.v2/CircleCI.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/pkl.experimental.uri@1.0.0#/URI.pkl"
-import ".../pkl-pantry/packages/pkl.experimental.uri/URI.pkl"
 
 /// The OS to run on
 os: "macOS"|"linux"
@@ -29,7 +28,7 @@ arch: "amd64"|"aarch64"
 /// Whether to link to musl. Otherwise, links to glibc.
 musl: Boolean = false
 
-local setupLinuxEnvironment: CircleCI.RunStep =
+local setupLinuxEnvironment: Config.RunStep =
   let (jdkVersion = "11.0.20.1+1")
   let (muslVersion = "1.2.2")
   let (zlibVersion = "1.2.13")
@@ -96,12 +95,12 @@ local setupLinuxEnvironment: CircleCI.RunStep =
 
 steps {
   when (os == "linux") {
-    new CircleCI.RestoreCacheStep {
+    new Config.RestoreCacheStep {
       name = "Restore static deps from cache"
       key = "staticdeps-\(arch)"
     }
     setupLinuxEnvironment
-    new CircleCI.SaveCacheStep {
+    new Config.SaveCacheStep {
       name = "Save statics deps to cache"
       key = "staticdeps-\(arch)"
       paths {
@@ -110,7 +109,7 @@ steps {
     }
   }
   when (os == "macOS" && arch == "amd64") {
-    new CircleCI.RunStep {
+    new Config.RunStep {
       name = "Installing Rosetta 2"
       command = """
         /usr/sbin/softwareupdate --install-rosetta --agree-to-license
@@ -121,11 +120,11 @@ steps {
   // We can't use GraalVM 23 for any other build because we need to support Java 11, which was
   // dropped in GraalVM 23.
   when (os == "macOS" && arch == "aarch64") {
-    new CircleCI.RunStep {
+    new Config.RunStep {
       command = "git apply patches/graalVm23.patch"
     }
   }
-  new CircleCI.RunStep {
+  new Config.RunStep {
     name = "gradle buildNative"
     local _os =
       if (os == "macOS") "mac"
@@ -137,7 +136,7 @@ steps {
       ./gradlew \#(module.gradleArgs) pkl-cli:\#(jobName) pkl-core:test\#(jobName.capitalize())
       """#
   }
-  new CircleCI.PersistToWorkspaceStep {
+  new Config.PersistToWorkspaceStep {
     root = "."
     paths {
       "pkl-cli/build/executable/"

.circleci/jobs/DeployJob.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 extends "GradleJob.pkl"
 
-import ".../pkl-pantry/packages/com.circleci.v2/CircleCI.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.0#/Config.pkl"
 
 local self = this
 
@@ -28,8 +28,15 @@ job {
 }
 
 steps {
-  new CircleCI.AttachWorkspaceStep { at = "." }
+  new Config.AttachWorkspaceStep { at = "." }
-  new CircleCI.RunStep {
+  new Config.RunStep {
     command = "./gradlew \(self.gradleArgs) \(module.command)"
   }
+  // add jpkl to workspace so it gets published as a GitHub release
+  new Config.PersistToWorkspaceStep {
+    root = "."
+    paths {
+      "pkl-cli/build/executable/"
+    }
+  }
 }

.circleci/jobs/GradleCheckJob.pkl

@@ -15,12 +15,12 @@
 //===----------------------------------------------------------------------===//
 extends "GradleJob.pkl"
 
-import ".../pkl-pantry/packages/com.circleci.v2/CircleCI.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.0#/Config.pkl"
 
 javaVersion: "11.0"|"17.0"
 
 steps {
-  new CircleCI.RunStep {
+  new Config.RunStep {
     name = "gradle check"
     command = "./gradlew \(module.gradleArgs) check"
   }

.circleci/jobs/GradleJob.pkl

@@ -15,7 +15,7 @@
 //===----------------------------------------------------------------------===//
 abstract module GradleJob
 
-import ".../pkl-pantry/packages/com.circleci.v2/CircleCI.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.0#/Config.pkl"
 
 /// Whether this is a release build or not.
 isRelease: Boolean = false
@@ -28,16 +28,16 @@ fixed gradleArgs = new Listing {
   }
 }.join(" ")
 
-steps: Listing<CircleCI.Step>
+steps: Listing<Config.Step>
 
-job: CircleCI.Job = new {
+job: Config.Job = new {
   environment {
     ["LANG"] = "en_US.UTF-8"
   }
   steps {
     "checkout"
     ...module.steps
-    new CircleCI.RunStep {
+    new Config.RunStep {
       // find all test results and write them to the home dir
       name = "Gather test results"
       command = """
@@ -46,7 +46,7 @@ job: CircleCI.Job = new {
         """
       `when` = "always"
     }
-    new CircleCI.StoreTestResults {
+    new Config.StoreTestResults {
       path = "~/test-results"
     }
   }

.circleci/jobs/SimpleGradleJob.pkl

@@ -15,14 +15,14 @@
 //===----------------------------------------------------------------------===//
 extends "GradleJob.pkl"
 
-import ".../pkl-pantry/packages/com.circleci.v2/CircleCI.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.0#/Config.pkl"
 
 name: String = command
 
 command: String
 
 steps {
-  new CircleCI.RunStep {
+  new Config.RunStep {
     name = module.name
     command = """
       ./gradlew \(module.gradleArgs) \(module.command)

buildSrc/src/main/kotlin/BuildInfo.kt

@@ -95,6 +95,11 @@ open class BuildInfo(project: Project) {
     java.lang.Boolean.getBoolean("releaseBuild")
   }
 
+  val hasMuslToolchain: Boolean by lazy {
+    // see "install musl" in .circleci/jobs/BuildNativeJob.pkl
+    File(System.getProperty("user.home"), "staticdeps/bin/x86_64-linux-musl-gcc").exists()
+  }
+
   val os: org.gradle.internal.os.OperatingSystem by lazy {
     org.gradle.internal.os.OperatingSystem.current()
   }

docs/antora.yml

@@ -1,6 +1,6 @@
 name: main
 title: Main Project
-version: 0.25.0
+version: 0.25.3
 prerelease: false
 nav:
 - nav.adoc

docs/modules/ROOT/pages/language-bindings.adoc

@@ -4,3 +4,6 @@
 * xref:kotlin-binding:index.adoc[Kotlin]
 * xref:swift:ROOT:index.adoc[Swift]
 * xref:go:ROOT:index.adoc[Go]
+* xref:bindings-specification:index.adoc[Specification]
+** xref:bindings-specification:message-passing-api.adoc[Message Passing API]
+** xref:bindings-specification:binary-encoding.adoc[Pkl Binary Encoding]

docs/modules/ROOT/partials/component-attributes.adoc

@@ -3,7 +3,7 @@
 // the following attributes must be updated immediately before a release
 
 // pkl version corresponding to current git commit without -dev suffix or git hash
-:pkl-version-no-suffix: 0.25.0
+:pkl-version-no-suffix: 0.25.3
 // tells whether pkl version corresponding to current git commit
 // is a release version (:is-release-version: '') or dev version (:!is-release-version:)
 :is-release-version: ''
@@ -21,9 +21,14 @@ ifdef::is-release-version[]
 :pkl-artifact-version: {pkl-version}
 endif::[]
 
-:uri-maven-docsite: https://central.sonatype.com/
+:uri-maven-docsite: https://central.sonatype.com
 
-:uri-sonatype: https://s01.oss.sonatype.org/service/local/repositories/snapshots/content/
+:uri-sonatype: https://s01.oss.sonatype.org/content/groups/public
+
+:uri-maven-repo: https://s01.oss.sonatype.org/content/groups/public
+ifdef::is-release-version[]
+:uri-maven-repo: https://repo1.maven.org/maven2
+endif::[]
 
 :symbolic-version-name: latest
 ifdef::is-release-version[]
@@ -34,10 +39,9 @@ endif::[]
 :uri-pkl-stdlib-docs: {uri-pkl-stdlib-docs-base}/{pkl-version}
 :uri-pkl-stdlib-docs-index: {uri-pkl-stdlib-docs}/
 
-// TODO(oss): check these links when we have tags
 :github-branch: main
 ifdef::is-release-version[]
-:github-branch: v{pkl-version-no-suffix}
+:github-branch: {pkl-version-no-suffix}
 endif::[]
 :uri-github-tree: https://github.com/apple/pkl/tree/{github-branch}
 :uri-pkl-stdlib-sources: {uri-github-tree}/stdlib
@@ -62,3 +66,76 @@ endif::[]
 :uri-config-java-example: {uri-pkl-examples-tree}/config-java
 :uri-config-kotlin-example: {uri-pkl-examples-tree}/config-kotlin
 :uri-pkldoc-example: {uri-pkl-examples-tree}/pkldoc
+
+:uri-stdlib-baseModule: {uri-pkl-stdlib-docs}/base
+:uri-stdlib-jsonnetModule: {uri-pkl-stdlib-docs}/jsonnet
+:uri-stdlib-reflectModule: {uri-pkl-stdlib-docs}/reflect
+:uri-stdlib-xmlModule: {uri-pkl-stdlib-docs}/xml
+:uri-stdlib-protobufModule: {uri-pkl-stdlib-docs}/protobuf
+:uri-stdlib-Boolean: {uri-stdlib-baseModule}/Boolean
+:uri-stdlib-xor: {uri-stdlib-baseModule}/Boolean#xor()
+:uri-stdlib-implies: {uri-stdlib-baseModule}/Boolean#implies()
+:uri-stdlib-Any: {uri-stdlib-baseModule}/Any
+:uri-stdlib-String: {uri-stdlib-baseModule}/String
+:uri-stdlib-Int: {uri-stdlib-baseModule}/Int
+:uri-stdlib-Float: {uri-stdlib-baseModule}/Float
+:uri-stdlib-Number: {uri-stdlib-baseModule}/Number
+:uri-stdlib-NaN: {uri-stdlib-baseModule}/#NaN
+:uri-stdlib-Infinity: {uri-stdlib-baseModule}/#Infinity
+:uri-stdlib-isBetween: {uri-stdlib-baseModule}/Number#isBetween
+:uri-stdlib-isFinite: {uri-stdlib-baseModule}/Number#isFinite
+:uri-stdlib-Int8: {uri-stdlib-baseModule}/#Int8
+:uri-stdlib-Int16: {uri-stdlib-baseModule}/#Int16
+:uri-stdlib-Int32: {uri-stdlib-baseModule}/#Int32
+:uri-stdlib-UInt8: {uri-stdlib-baseModule}/#UInt8
+:uri-stdlib-UInt16: {uri-stdlib-baseModule}/#UInt16
+:uri-stdlib-UInt32: {uri-stdlib-baseModule}/#UInt32
+:uri-stdlib-UInt: {uri-stdlib-baseModule}/#UInt
+:uri-stdlib-Uri: {uri-stdlib-baseModule}/#Uri
+:uri-stdlib-matches: {uri-stdlib-baseModule}/String#matches()
+:uri-stdlib-Null: {uri-stdlib-baseModule}/Null
+:uri-stdlib-ifNonNull: {uri-stdlib-baseModule}/Null#ifNonNull()
+:uri-stdlib-List: {uri-stdlib-baseModule}/List
+:uri-stdlib-Set: {uri-stdlib-baseModule}/Set
+:uri-stdlib-Map: {uri-stdlib-baseModule}/Map
+:uri-stdlib-Listing: {uri-stdlib-baseModule}/Listing
+:uri-stdlib-Listing-default: {uri-stdlib-baseModule}/Listing#default
+:uri-stdlib-Listing-isDistinct: {uri-stdlib-baseModule}/Listing#isDistinct
+:uri-stdlib-Listing-isDistinctBy: {uri-stdlib-baseModule}/Listing#isDistinctBy()
+:uri-stdlib-Mapping: {uri-stdlib-baseModule}/Mapping
+:uri-stdlib-Mapping-default: {uri-stdlib-baseModule}/Mapping#default
+:uri-stdlib-Duration: {uri-stdlib-baseModule}/Duration
+:uri-stdlib-Duration-value: {uri-stdlib-baseModule}/Duration#value
+:uri-stdlib-Duration-unit: {uri-stdlib-baseModule}/Duration#unit
+:uri-stdlib-DurationUnit: {uri-stdlib-baseModule}/#DurationUnit
+:uri-stdlib-DataSize: {uri-stdlib-baseModule}/DataSize
+:uri-stdlib-DataSize-value: {uri-stdlib-baseModule}/DataSize#value
+:uri-stdlib-DataSize-unit: {uri-stdlib-baseModule}/DataSize#unit
+:uri-stdlib-DataSizeUnit: {uri-stdlib-baseModule}/#DataSizeUnit
+:uri-stdlib-Dynamic: {uri-stdlib-baseModule}/Dynamic
+:uri-stdlib-Dynamic-toTyped: {uri-stdlib-baseModule}/Dynamic#toTyped()
+:uri-stdlib-Typed: {uri-stdlib-baseModule}/Typed
+:uri-stdlib-Regex: {uri-stdlib-baseModule}/Regex
+:uri-stdlib-Regex-method: {uri-stdlib-baseModule}/#Regex()
+:uri-stdlib-Regex-match: {uri-stdlib-baseModule}/Regex#match
+:uri-stdlib-RegexMatch: {uri-stdlib-baseModule}/RegexMatch
+:uri-stdlib-Pair: {uri-stdlib-baseModule}/Pair
+:uri-stdlib-IntSeq: {uri-stdlib-baseModule}/IntSeq
+:uri-stdlib-Class: {uri-stdlib-baseModule}/Class
+:uri-stdlib-TypeAlias: {uri-stdlib-baseModule}/TypeAlias
+:uri-stdlib-Deprecated: {uri-stdlib-baseModule}/Deprecated
+:uri-stdlib-ValueRenderer: {uri-stdlib-baseModule}/ValueRenderer
+:uri-stdlib-PcfRenderer-converters: {uri-stdlib-baseModule}/PcfRenderer#converters
+:uri-stdlib-Function: {uri-stdlib-baseModule}/Function
+:uri-stdlib-Function0: {uri-stdlib-baseModule}/Function0
+:uri-stdlib-Function1: {uri-stdlib-baseModule}/Function1
+:uri-stdlib-Function1-apply: {uri-stdlib-baseModule}/Function1#apply()
+:uri-stdlib-Function2: {uri-stdlib-baseModule}/Function2
+:uri-stdlib-Function3: {uri-stdlib-baseModule}/Function3
+:uri-stdlib-Function4: {uri-stdlib-baseModule}/Function4
+:uri-stdlib-Function5: {uri-stdlib-baseModule}/Function5
+:uri-stdlib-Resource: {uri-stdlib-baseModule}/Resource
+:uri-stdlib-outputFiles: {uri-stdlib-baseModule}/ModuleOutput#files
+
+:uri-messagepack: https://msgpack.org/index.html
+:uri-messagepack-spec: https://github.com/msgpack/msgpack/blob/master/spec.md

docs/modules/bindings-specification/pages/binary-encoding.adoc

@@ -0,0 +1,197 @@
+= Pkl Binary Encoding
+include::ROOT:partial$component-attributes.adoc[]
+include::partial$component-attributes.adoc[]
+
+Pkl values can be encoded into a binary format.
+This format is used for Pkl's non-JVM language bindings, for example, for its Go and Swift bindings.
+
+The binary format is uses link:{uri-messagepack}[MessagePack] encoding.
+
+== Primitives
+
+All Pkl primitives turn into their respective MessagePack primitive.
+
+|===
+|Pkl Type|MessagePack format
+
+|link:{uri-stdlib-Int}[Int]
+|link:{uri-messagepack-int}[int]
+
+|link:{uri-stdlib-Float}[Float]
+|link:{uri-messagepack-float}[float]
+
+|link:{uri-stdlib-String}[String]
+|link:{uri-messagepack-str}[string]
+
+|link:{uri-stdlib-Boolean}[Boolean]
+|link:{uri-messagepack-bool}[bool]
+
+|link:{uri-stdlib-Null}[Null]
+|link:{uri-messagepack-nil}[nil]
+|===
+
+NOTE: Pkl integers are encoded into the smallest int type that the number will fit into.
+For example, value `8` gets encoded as MessagePack `int8` format.
+
+== Non-primitives
+
+All non-primitive values are encoded as MessagePack arrays.
+The first slot of the array designates the value's type. The remaining slots have fixed meanings depending on the type.
+
+The array's length is the number of slots that are filled. For example, xref:{uri-stdlib-List}[List] is encoded as an MessagePack array with two elements.
+
+|===
+|Pkl type |Slot 1 2+|Slot 2 2+|Slot 3 2+|Slot 4
+
+||code |type |description |type |description |type |description
+
+|link:{uri-stdlib-Typed}[Typed], link:{uri-stdlib-Dynamic}[Dynamic]
+|`0x1`
+|link:{uri-messagepack-str}[str]
+|Fully qualified class name
+|link:{uri-messagepack-str}[str]
+|Enclosing module URI
+|link:{uri-messagepack-array}[array]
+|Array of <<object-members,object members>>
+
+|link:{uri-stdlib-Map}[Map]
+|`0x2`
+|link:{uri-messagepack-map}[map]
+|Map of `<value>` to `<value>`
+|
+|
+|
+|
+
+|link:{uri-stdlib-Mapping}[Mapping]
+|`0x3`
+|link:{uri-messagepack-map}[map]
+|Map of `<value>` to `<value>`
+|
+|
+|
+|
+
+|link:{uri-stdlib-List}[List]
+|`0x4`
+|link:{uri-messagepack-array}[array]
+|Array of `<value>`
+|
+|
+|
+|
+
+|link:{uri-stdlib-Listing}[Listing]
+|`0x5`
+|link:{uri-messagepack-array}[array]
+|Array of `<value>`
+|
+|
+|
+|
+
+|link:{uri-stdlib-Set}[Set]
+|`0x6`
+|link:{uri-messagepack-array}[array]
+|Array of `<value>`
+|
+|
+|
+|
+
+|link:{uri-stdlib-Duration}[Duration]
+|`0x7`
+|{uri-messagepack-float}[float64]
+|Duration value
+|link:{uri-messagepack-str}[str]
+|link:{uri-stdlib-DurationUnit}[Duration unit] (`"ns"`, `"ms"`, etc.)
+|
+|
+
+|link:{uri-stdlib-DataSize}[DataSize]
+|`0x8`
+|link:{uri-messagepack-float}[float64]
+|Value (float64)
+|link:{uri-messagepack-str}[str]
+|link:{uri-stdlib-DataSizeUnit}[DataSize unit] (`"b"`, `"kb"`, etc.)
+|
+|
+
+|link:{uri-stdlib-Pair}[Pair]
+|`0x9`
+|`<value>`
+|First value
+|`<value>`
+|Second value
+|
+|
+
+|link:{uri-stdlib-IntSeq}[IntSeq]
+|`0xA`
+|link:{uri-messagepack-int}[int]
+|Start
+|link:{uri-messagepack-int}[int]
+|End
+|link:{uri-messagepack-int}[int]
+|Step
+
+|link:{uri-stdlib-Regex}[Regex]
+|`0xB`
+|link:{uri-messagepack-str}[str]
+|Regex string representation
+|
+|
+|
+|
+
+|link:{uri-stdlib-Class}[Class]
+|`0xC`
+|
+|
+|
+|
+|
+|
+
+|link:{uri-stdlib-TypeAlias}[TypeAlias]
+|`0xD`
+|
+|
+|
+|
+|
+|
+|===
+
+[[object-members]]
+== Object Members
+
+Like non-primitive values, object members are encoded as MessagePack arrays, where the first slot designates the value's type.
+
+|===
+|Member type |Slot 1 2+|Slot 2 2+|Slot 3
+
+| |code |type |description |type |description
+
+|Property
+|`0x10`
+|link:{uri-messagepack-str}[str]
+|key
+|`<value>`
+|property value
+
+|Entry
+|`0x11`
+|`<value>`
+|entry key
+|`<value>`
+|entry value
+
+|Element
+|`0x12`
+|link:{uri-messagepack-int}[int]
+|index
+|`<value>`
+|element value
+|===
+

docs/modules/bindings-specification/pages/index.adoc

@@ -0,0 +1,173 @@
+= Language Binding Specification
+
+:uri-pkl-go-github: https://github.com/apple/pkl-go
+:uri-pkl-swift-github: https://github.com/apple/pkl-swift
+
+Pkl can be embedded within any host application.
+The host application has access to low level controls.
+It is able to manage the lifecycle of evaluators, as well as provide custom modules and resources to Pkl.
+
+Currently, Pkl must be embedded as a child process, by shelling out to the CLI using the xref:pkl-cli:index.adoc#command-server[`pkl server`] command. In the future, a C library will also be provided.
+
+When embedded, communication between a host application and Pkl happens via message passing.
+The message passing specification can be found in xref:message-passing-api.adoc[].
+
+For examples of language bindings in practice, review the xref:{uri-pkl-go-github}[pkl-go], or the xref:{uri-pkl-swift-github}[pkl-swift] codebases.
+
+NOTE: Pkl's Java and Kotlin libraries binds to Pkl directly, and do not use message passing.
+
+== Features of a language binding
+
+A language binding for Pkl should generally have the following components:
+
+. A client that spawns `pkl server`, and talks to it using message passing.
+. A deserializer that turns xref:binary-encoding.adoc[pkl binary encoding] into a structure in the host language.
+. A code generator that transforms Pkl schemas into schemas written in the host language.
+  The code generator is mostly written in Pkl, with a lightweight executable that acts as the glue layer.
+  For examples of code generators, consult link:{uri-pkl-go-github}/tree/main/codegen[pkl-go] and link:{uri-pkl-swift-github}/tree/main/codegen[pkl-swift].
+
+== Sample flow
+
+Here is a sample flow for evaluating a module with the following contents:
+
+.\file:///path/to/myModule.pkl
+[source,{pkl}]
+----
+module MyModule
+
+theModules = import*("customfs:/*.pkl")
+----
+
+. Client sends xref:message-passing-api.adoc#create-evaluator-request[Create Evaluator Request], including `customfs` as a custom module reader.
++
+[source,json]
+----
+[
+  0x20,
+  {
+    "requestId": 135,
+    "allowedModules": ["pkl:", "repl:", "file:", "customfs:"],
+    "clientModuleReaders": [
+      {
+        "scheme": "customfs",
+        "hasHierarchicalUris": true,
+        "isGlobbable": true,
+        "isLocal": true
+      }
+    ]
+  }
+]
+----
+. Server sends xref:message-passing-api.adoc#create-evaluator-response[Create Evaluator Response], with an evaluator id.
++
+[source,json]
+----
+[
+  0x21,
+  {
+    "requestId": 135,
+    "evaluatorId": -135901
+  }
+]
+----
+. Client sends xref:message-passing-api.adoc#evaluate-request[Evaluate Request], providing the module's URI.
++
+[source,json]
+----
+[
+  0x23,
+  {
+    "requestId": 9805131,
+    "evaluatorId": -13901,
+    "moduleUri": "file:///path/to/myModule.pkl"
+  }
+]
+----
+. During evaluation, server evaluates `import*("customfs:/*.pkl")`, and sends xref:message-passing-api.adoc#list-modules-request[List Modules Request].
++
+[source,json]
+----
+[
+  0x2c,
+  {
+    "requestId": -6478924,
+    "evaluatorId": -13901,
+    "uri": "customfs:/"
+  }
+]
+----
+. Client responds with xref:message-passing-api.adoc#list-modules-response[List Modules Response].
+In our pretend scenario, there is only one file; `foo.pkl`.
++
+[source,json]
+----
+[
+  0x2d,
+  {
+    "requestId": -6478924,
+    "evaluatorId": -13901,
+    "pathElements": [
+      {
+        "name": "foo.pkl",
+        "isDirectory": false
+      }
+    ]
+  }
+]
+----
+. Server sends xref:message-passing-api.adoc#read-module-request[Read Module Request] to read `foo.pkl`.
++
+[source,json]
+----
+[
+  0x28,
+  {
+    "requestId": 36408291,
+    "evaluatorId": -13901,
+    "uri": "customfs:/foo.pkl"
+  }
+]
+----
+. Client responds with the module's contents
++
+[source,json]
+----
+[
+  0x29,
+  {
+    "requestId": 36408291,
+    "evaluatorId": -13901,
+    "contents": "foo = 1"
+  }
+]
+----
+. Server finishes evaluation, and responds with the xref:message-passing-api.adoc#evaluate-response[Evaluate Response].
++
+[source,json]
+----
+[
+  0x24,
+  {
+    "requestId": 9805131,
+    "evaluatorId": -13901,
+    "result": <pkl binary value>
+  }
+]
+----
+. Client sends xref:message-passing-api.adoc#close-evaluator[Close Evaluator].
++
+[source,json]
+----
+[
+  0x22,
+  {
+    "evaluatorId": -13901
+  }
+]
+----
+
+== Debug logs
+
+Set the env var `PKL_DEBUG=1` to enable more verbose logging from Pkl.
+It is recommended that clients also use this environment variable to enable debug logs of their own.
+

docs/modules/bindings-specification/pages/message-passing-api.adoc

@@ -0,0 +1,531 @@
+= Message Passing API
+
+include::ROOT:partial$component-attributes.adoc[]
+include::partial$component-attributes.adoc[]
+
+All messages are encoded in link:{uri-messagepack}[MessagePack], as an array with two elements.
+
+The first element of the array is a code that designates the message's type, encoded as an int.
+The second element of the array is the message body, encoded as a map.
+
+Messages are passed between the _client_ and the _server_.
+The _client_ is the host language (for example, the Swift application when using pkl-swift).
+The _server_ is the entity that provides controls for interacting with Pkl.
+
+For example, in JSON representation:
+
+[source,json]
+----
+[
+  1,                           // <1>
+  { "someKey": "someValue" }   // <2>
+]
+----
+<1> Code indicating message type
+<2> Message body
+
+== Message types
+
+[[client-message]]
+=== Client Message
+A message passed from the client to the server.
+
+[[server-message]]
+=== Server Message
+A message passed from the server to the client.
+
+[[request-message]]
+=== Request Message
+A message sent with a `requestId` value.
+The `requestId` should be a unique number at the time of message send.
+The other side is expected to respond with a <<response-message>> with the same `requestId`.
+
+[[response-message]]
+=== Response Message
+A message that is the response to a <<request-message>>.
+It contains the same `requestId` of the request message.
+
+[[one-way-message]]
+=== One Way Message
+
+A fire-and-forget message where no response is expected.
+
+== Messages
+
+All messages have their schema described in Pkl.
+A nullable type means that the property should be omitted (as opposed to the property's value being `nil`).
+
+[[create-evaluator-request]]
+=== Create Evaluator Request
+
+Code: `0x20` +
+Type: <<client-message,Client>> <<request-message,Request>>
+
+Create an evaluator with the provided evaluator settings.
+Upon creating the evaluator, the server sends back a <<create-evaluator-response>> message.
+
+Schema:
+[source,pkl]
+----
+/// A number identifying this request
+requestId: Int
+
+/// Regex patterns to determine which modules are allowed for import.
+///
+/// API version of the CLI's `--allowed-modules` flag
+allowedModules: Listing<String>?
+
+/// Regex patterns to dettermine which resources are allowed to be read.
+///
+/// API version of the CLI's `--allowed-resources` flag
+allowedResources: Listing<String>?
+
+/// Register client-side module readers.
+clientModuleReaders: Listing<ClientModuleReader>?
+
+/// Register client-side resource readers.
+clientResourceReaders: Listing<ClientResourceReader>?
+
+/// Directories, ZIP archives, or JAR archives
+/// to search when resolving `modulepath:` URIs.
+///
+/// API version of the CLI's `--module-path` flag.
+modulePaths: Listing<String>?
+
+/// Environment variable to set.
+///
+/// API version of the CLI's `--env-var` flag.
+env: Mapping<String, String>?
+
+/// External properties to set.
+///
+/// API version of the CLI's `--properties` flag.
+properties: Mapping<String, String>?
+
+/// Duration, in seconds, after which evaluation of a source module will be timed out.
+///
+/// API version of the CLI's `--timeout` flag.
+timeoutSeconds: Int?
+
+/// Restricts access to file-based modules and resources to those located under the root directory.
+rootDir: String?
+
+/// The cache directory for storing packages.
+cacheDir: String?
+
+/// The format to generate.
+///
+/// This sets the `pkl.outputFormat` external property.
+outputFormat: String?
+
+/// The project dependency settings.
+project: Project?
+
+class ClientResourceReader {
+  /// The URI scheme this reader is responsible for reading.
+  scheme: String
+
+  /// Tells whether the path part of ths URI has a
+  /// [hier-part](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
+  ///
+  /// An example of a hierarchical URI is `file:///path/to/my/file`, where
+  /// `/path/to/my/file` designates a nested path through the `/` character.
+  ///
+  /// An example of a non-hierarchical URI is `pkl.base`, where the `base` does not denote
+  /// any form of hierarchy.
+  hasHierarchicalUris: Boolean
+
+  /// Tells whether this reader supports globbing.
+  isGlobbable: Boolean
+}
+
+class ClientModuleReader {
+  /// The URI scheme this reader is responsible for reading.
+  scheme: String
+
+  /// Tells whether the path part of ths URI has a
+  /// [hier-part](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
+  ///
+  /// An example of a hierarchical URI is `file:///path/to/my/file`, where
+  /// `/path/to/my/file` designates a nested path through the `/` character.
+  ///
+  /// An example of a non-hierarchical URI is `pkl.base`, where the `base` does not denote
+  /// any form of hierarchy.
+  hasHierarchicalUris: Boolean
+
+  /// Tells whether this reader supports globbing.
+  isGlobbable: Boolean
+
+  /// Tells whether the module is local to the system.
+  ///
+  /// A local resource that [hasHierarchicalUris] supports triple-dot imports.
+  isLocal: Boolean
+}
+
+class Project {
+  type: "local"
+
+  /// The canonical URI of this project's package
+  packageUri: String?
+
+  /// The URI pointing to the location of the project file.
+  projectFileUri: String
+
+  /// The dependencies of this project.
+  dependencies: Mapping<String, Project|RemoteDependency>
+}
+
+class RemoteDependency {
+  type: "remote"
+
+  /// The canonical URI of this dependency
+  packageUri: String?
+
+  /// The checksums of this remote dependency
+  checksums: Checksums?
+}
+
+class Checksums {
+  /// The sha-256 checksum of this dependency's metadata.
+  sha256: String
+}
+----
+
+Example:
+[source,json5]
+----
+[
+  0x20,
+  {
+    "requestId": 193501,
+    "allowedModules": ["pkl:", "repl:"],
+    "allowedResources": ["file:", "package:", "projectpackage:"]
+  }
+]
+----
+
+[[create-evaluator-response]]
+=== Create Evaluator Response
+
+Code: `0x21` +
+Type: <<server-message,Server>> <<response-message,Response>>
+
+The response for a <<create-evaluator-request>>.
+If the evaluator was created successfully, `evaluatorId` is set. Otherwise, `error` is set to the resulting error.
+
+[source,pkl]
+----
+/// A number identifying this request
+requestId: Int
+
+/// A number identifying the created evaluator.
+evaluatorId: Int?
+
+/// A message detailing why the evaluator was not created.
+error: String?
+----
+
+[[close-evaluator]]
+=== Close Evaluator
+
+Code: `0x22` +
+Type: <<client-message,Client>> <<one-way-message,One Way>>
+
+Tells the Pkl server to close an evaluator, releasing any resources it may be holding.
+
+[source,pkl]
+----
+/// A number identifying this evaluator.
+evaluatorId: Int
+----
+
+[[evaluate-request]]
+=== Evaluate Request
+
+Code: `0x23` +
+Type: <<client-message,Client>> <<request-message,Request>>
+
+Evaluate a module.
+
+[source,pkl]
+----
+/// A number identifying this request
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The absolute URI of the module to be evaluated.
+moduleUri: String
+
+/// The module's contents.
+///
+/// If [null], Pkl will load the module at runtime.
+moduleText: String?
+
+/// The Pkl expression to be evaluated within the module.
+///
+/// If [null], evaluates the whole module.
+expr: String?
+----
+
+[[evaluate-response]]
+=== Evaluate Response
+
+Code: `0x24` +
+Type: <<server-message,Server>> <<response-message,Response>>
+
+The server's response to <<evaluate-request>>.
+If the evaluation is successful, the response is the Pkl value encoded in xref:binary-encoding.adoc[binary encoding].
+
+[source,pkl]
+----
+/// The requestId of the Evaluate request
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The evaluation contents, if successful.
+result: Binary? // <1>
+
+/// A message detailing why evaluation failed.
+error: String?
+
+typealias Binary = Any // <1>
+----
+<1> xref:binary-encoding.adoc[Pkl Binary Encoding] in link:{uri-messagepack-bin}[bin format] (not expressable in Pkl)
+
+[[log]]
+=== Log
+
+Code: `0x25` +
+Type: <<server-message,Server>> <<one-way-message,One Way>>
+
+Tells the client to emit a log message, during the execution of a Pkl program.
+A log can occur through a xref:language-reference:index.adoc#debugging[trace()] expression, or through a warning (for example, when encountering a link:{uri-stdlib-Deprecated}[Deprecated] value.)
+
+[source,pkl]
+----
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// A number identifying the log level.
+///
+/// - 0: trace
+/// - 1: warn
+level: Int(this == 0 || this == 1)
+
+/// The message to be logged
+message: String
+
+/// A string representing the source location within Pkl code producing this log output.
+frameUri: String
+----
+
+[[read-resource-request]]
+=== Read Resource Request
+
+Code: `0x26` +
+Type: <<server-message,Server>> <<request-message,Request>>
+
+Read a resource at the given URI.
+This message occurs when a read expression (`read`/`read?`/`read*`) is encountered within a program, and its scheme matches a client resource reader.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The URI of the resource.
+uri: String
+----
+
+[[read-resource-response]]
+=== Read Resource Response
+
+Code: `0x27` +
+Type: <<client-message,Client>> <<response-message,Response>>
+
+The response to <<read-resource-request>>.
+If successful, `contents` is set.
+Otherwise, `error` is set.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The contents of the resource.
+contents: Binary? // <1>
+
+/// The description of the error that occured when reading this resource.
+error: String?
+
+typealias Binary = Any // <1>
+----
+<1> MessagePack's link:https://github.com/msgpack/msgpack/blob/master/spec.md#bin-format-family[bin format family] (not expressable in Pkl)
+
+[[read-module-request]]
+=== Read Module Request
+
+Code: `0x28` +
+Type: <<server-message,Server>> <<request-message,Request>>
+
+Read a module at the given URI.
+This message occurs during the evaluation of an import statement or expression (`import`/`import*`), when a scheme matches a client module reader.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The URI of the module.
+uri: String
+----
+
+[[read-module-response]]
+=== Read Module Response
+
+Code: `0x29` +
+Type: <<client-message,Client>> <<response-message,Response>>
+
+The response to <<read-module-request>>.
+If successful, `contents` is set.
+Otherwise, `error` is set.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The string contents of the module.
+contents: String?
+
+/// The description of the error that occured when reading this resource.
+error: String?
+----
+
+[[list-resources-request]]
+=== List Resources Request
+
+Code: `0x2a` +
+Type: <<server-message,Server>> <<request-message,Request>>
+
+List resources at the specified base path.
+This message occurs during the evaluation of a xref:language-reference:index.adoc#globbed-reads[globbed read], when a scheme matches a client resource reader's scheme.
+
+If the resource reader does not have hierarchical URIs, `dummy` is used as the path, and the response is expected to contain all resource elements for that scheme.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The base URI to list resources.
+uri: String
+----
+
+[[list-resources-response]]
+=== List Resources Response
+
+Code: `0x2b` +
+Type: <<client-message,Client>> <<response-message,Response>>
+
+The response to <<list-resources-request>>.
+If successful, `pathElements` is set.
+Otherwise, `error` is set.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The elements at the provided base path.
+pathElements: Listing<PathElement>?
+
+/// The description of the error that occured when listing elements.
+error: String?
+
+class PathElement {
+  /// The name of the element at this path
+  name: String
+
+  /// Tells whether the element is a directory.
+  isDirectory: Boolean
+}
+----
+
+[[list-modules-request]]
+=== List Modules Request
+
+Code: `0x2c` +
+Type: <<server-message,Server>> <<request-message,Request>>
+
+List modules at the specified base path.
+This message occurs during the evaluation of a xref:language-reference:index.adoc#globbed-imports[globbed import], when a scheme matches a client resource reader's scheme.
+
+If the module reader does not have hierarchical URIs, `dummy` is used as the path, and the response is expected to contain all module elements for that scheme.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The base URI to list modules.
+uri: String
+----
+
+[[list-modules-response]]
+=== List Modules Response
+
+Code: `0x2d` +
+Type: <<client-message,Client>> <<response-message,Response>>
+
+The response to <<list-modules-request>>.
+If successful, `pathElements` is set.
+Otherwise, `error` is set.
+
+[source,pkl]
+----
+/// A number identifying this request.
+requestId: Int
+
+/// A number identifying this evaluator.
+evaluatorId: Int
+
+/// The elements at the provided base path.
+pathElements: Listing<PathElement>?
+
+/// The description of the error that occured when listing elements.
+error: String?
+
+class PathElement {
+  /// The name of the element at this path
+  name: String
+
+  /// Tells whether the element is a directory.
+  isDirectory: Boolean
+}
+----

docs/modules/bindings-specification/partials/component-attributes.adoc

@@ -0,0 +1,9 @@
+:uri-github-binary-encoding-snippet-tests: {uri-github-tree}/pkl-server/src/test/files/SnippetTests
+:uri-messagepack-bool: {uri-messagepack-spec}#bool-format-family
+:uri-messagepack-int: {uri-messagepack-spec}#int-format-family
+:uri-messagepack-float: {uri-messagepack-spec}#float-format-family
+:uri-messagepack-str: {uri-messagepack-spec}#str-format-family
+:uri-messagepack-bin: {uri-messagepack-spec}#bin-format-family
+:uri-messagepack-array: {uri-messagepack-spec}#array-format-family
+:uri-messagepack-map: {uri-messagepack-spec}#map-format-family
+:uri-messagepack-nil: {uri-messagepack-spec}#nil-format

docs/modules/introduction/pages/comparison.adoc

@@ -13,14 +13,14 @@ Also, Pkl's strong and weak points in comparison to other configuration language
 [[static-config-formats]]
 == Pkl vs. Static Config Formats
 
-Static configuration formats such as JSON, YAML, and XML work reasonably well for simple configuration needs.
+Static configuration formats such as JSON, YAML, TOML, and XML work reasonably well for simple configuration needs.
 However, they do have some shortcomings, including:
 
 . They are not very human-friendly to read and write. (JSON, XML)
-. They do not provide a way to split a large file into multiple smaller ones. (JSON, YAML)
+. They do not provide a way to split a large file into multiple smaller ones. (JSON, YAML, TOML)
-. They offer no way or very limited ways to abstract over repetitive configuration. (JSON, YAML, XML)
+. They offer no way or very limited ways to abstract over repetitive configuration. (JSON, YAML, TOML, XML)
-. They do not offer standardized or widely available schema validators. (JSON, YAML)
+. They do not offer standardized or widely available schema validators. (JSON, YAML, TOML)
-. They offer little or no schema-aware tooling. (JSON, YAML)
+. They offer little or no schema-aware tooling. (JSON, YAML, TOML)
 
 Pkl addresses these shortcomings as follows:
 

docs/modules/introduction/pages/use-cases.adoc

@@ -22,7 +22,7 @@ At the same time, anyone configuring your application -- whether that's your use
 +
 At the time of writing, Pkl offers configuration libraries for the JVM runtime, Swift, and also for Golang.
 +
-We maintian the following libraries:
+We maintain the following libraries:
 +
 * xref:java-binding:pkl-config-java.adoc[pkl-config-java] for Java compatible languages
 * xref:kotlin-binding:pkl-config-kotlin.adoc[pkl-config-kotlin] for the {uri-kotlin-homepage}[Kotlin] language.

docs/modules/java-binding/pages/codegen.adoc

@@ -45,11 +45,14 @@ dependencies {
   compile "org.pkl-lang:pkl-codegen-java:{pkl-artifact-version}"
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url "{uri-sonatype}" }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url "{uri-sonatype}" }
+endif::[]
+}
 ----
 
 Kotlin::
@@ -61,11 +64,14 @@ dependencies {
   compile("org.pkl-lang:pkl-codegen-java:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url = uri("{uri-sonatype}") }
+endif::[]
+}
 ----
 ====
 
@@ -82,7 +88,7 @@ To use the library in a Maven project, declare the following dependency:
     <artifactId>pkl-codegen-java</artifactId>
     <version>{pkl-artifact-version}</version>
   </dependency>
-ifndef::is-release-build[]
+ifndef::is-release-version[]
   <repositories>
     <repository>
       <id>sonatype-s01</id>

docs/modules/java-binding/pages/pkl-config-java.adoc

@@ -1,6 +1,6 @@
 = pkl-config-java Library
 include::ROOT:partial$component-attributes.adoc[]
-:uri-pkl-core-EvalException: {uri-pkl-core-main-sources}/EvalException.java
+:uri-pkl-core-PklException: {uri-pkl-core-main-sources}/PklException.java
 
 :uri-pkl-config-java-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-config-java-all
 :uri-pkl-config-java-main-sources: {uri-github-tree}/pkl-config-java/src/main/java/org/pkl/config/java
@@ -15,8 +15,7 @@ include::ROOT:partial$component-attributes.adoc[]
 :uri-pkl-config-java-ConverterFactories: {uri-pkl-config-java-main-sources}/mapper/ConverterFactories.java
 :uri-pkl-config-java-Converter: {uri-pkl-config-java-main-sources}/mapper/Converter.java
 :uri-pkl-config-java-ConverterFactory: {uri-pkl-config-java-main-sources}/mapper/ConverterFactory.java
-:uri-pkl-config-java-PObjectToObjectByCtorTestJava: {uri-pkl-config-java-test-sources}/mapper/PObjectToObjectByCtorTest.java
+:uri-pkl-config-java-PObjectToDataObjectTestJava: {uri-pkl-config-java-test-sources}/mapper/PObjectToDataObjectTest.java
-:uri-pkl-config-java-PObjectToObjectByCtorTestPkl: {uri-pkl-config-java-test-resources}/mapper/PObjectToObjectByCtorTest.pkl
 
 The _pkl-config-java_ library builds upon xref:pkl-core:index.adoc[pkl-core].
 It offers a higher-level API specifically designed for consuming application runtime configuration.
@@ -41,7 +40,12 @@ dependencies {
   compile "org.pkl-lang:pkl-config-java:{pkl-artifact-version}"
 }
 
-ifndef::is-release-build[]
+ifdef::is-release-version[]
+repositories {
+  mavenCentral()
+}
+endif::[]
+ifndef::is-release-version[]
 repositories {
   maven { url "{uri-sonatype}" }
 }
@@ -57,11 +61,14 @@ dependencies {
   compile("org.pkl-lang:pkl-config-java:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url = uri("{uri-sonatype}") }
+endif::[]
+}
 ----
 ====
 
@@ -80,7 +87,7 @@ To use the library in a Maven project, declare the following dependency:
     <artifactId>pkl-config-java</artifactId>
     <version>{pkl-artifact-version}</version>
   </dependency>
-ifndef::is-release-build[]
+ifndef::is-release-version[]
   <repositories>
     <repository>
       <id>sonatype-s01</id>
@@ -100,7 +107,7 @@ Unlike `pkl-config-java`, `pkl-config-java__-all__` is a fat Jar with renamed th
 
 The {uri-pkl-config-java-ConfigEvaluator}[`ConfigEvaluator`] class loads and evaluates Pkl modules.
 If evaluation succeeds, a {uri-pkl-config-java-Config}[`Config`] object is returned.
-Otherwise, an {uri-pkl-core-EvalException}[`EvalException`] with error details is thrown.
+Otherwise, a {uri-pkl-core-PklException}[`PklException`] with error details is thrown.
 
 The returned `Config` object represents the root of the Pkl configuration tree.
 Intermediate and leaf nodes are also represented as `Config` objects.
@@ -124,7 +131,7 @@ In this example, this is done with a try-with-resources statement.
 Note that objects returned by the evaluator remain valid after calling `close()`.
 <2> Evaluate the given text.
 Other `evaluate` methods read from files, URLs, and other sources.
-If evaluation fails, an {uri-pkl-core-EvalException}[`EvalException`] is thrown.
+If evaluation fails, an {uri-pkl-core-PklException}[`PklException`] is thrown.
 <3> Navigate from the config root to its `"pigeon"` child.
 <4> Navigate from `"pigeon"` to `"age"` and get the latter's value as an `int`.
 If conversion to the requested type fails, a `ConversionException` is thrown.
@@ -136,7 +143,7 @@ A `ConfigEvaluator` caches module sources and evaluation results.
 To clear the cache, for example to evaluate the same module again, close the evaluator and create a new one.
 
 For a ready-to-go example with full source code,
-see link:{uri-config-java-example}[config-java] in the _pkl/pkl-examples_ repository.
+see link:{uri-config-java-example}[config-java] in the _pkl-jvm-examples_ repository.
 
 [[object-mapping]]
 === Object Mapping
@@ -182,7 +189,7 @@ They need to be provided in one of the following ways:
 
 For a complete object mapping example, see:
 
-* {uri-pkl-config-java-PObjectToObjectByCtorTestJava}[`PObjectToObjectByCtorTest.java`]
+* {uri-pkl-config-java-PObjectToDataObjectTestJava}[`PObjectToDataObjectTest.java`]
 
 TIP: Together with xref:java-binding:codegen.adoc[code generation], object mapping provides a complete solution for consuming Pkl configuration as statically typed Java objects.
 Java code never drifts from the configuration structure defined in Pkl, and the entire configuration tree can be code-completed in Java IDEs.

docs/modules/kotlin-binding/pages/codegen.adoc

@@ -19,7 +19,7 @@ See xref:pkl-gradle:index.adoc#installation[Installation] in the Gradle plugin c
 === Java Library
 
 The `pkl-codegen-kotlin` library is available {uri-pkl-codegen-kotlin-maven-module}[from Maven Central].
-It requires Java 8 or higher and Kotlin 1.3 or higher.
+It requires Java 11 or higher and Kotlin 1.3 or higher.
 
 ==== Gradle
 
@@ -33,14 +33,17 @@ Groovy::
 [source,groovy,subs="+attributes"]
 ----
 dependencies {
-  compile "org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}"
+  compile "org.pkl-lang:pkl-codegen-kotlin:{pkl-artifact-version}"
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url "{uri-sonatype}" }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url "{uri-sonatype}" }
+endif::[]
+}
 ----
 
 Kotlin::
@@ -49,14 +52,17 @@ Kotlin::
 [source,kotlin,subs="+attributes"]
 ----
 dependencies {
-  compile("org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}")
+  compile("org.pkl-lang:pkl-codegen-kotlin:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url = uri("{uri-sonatype}") }
+endif::[]
+}
 ----
 ====
 

docs/modules/kotlin-binding/pages/pkl-config-kotlin.adoc

@@ -1,8 +1,8 @@
 = pkl-config-kotlin Library
 include::ROOT:partial$component-attributes.adoc[]
 :uri-pkl-config-kotlin-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-config-kotlin
-:uri-pkl-config-kotlin-main-sources: {uri-github-tree}/pkl-config-kotlin/src/main/kotlin/org/pkl/kotlin
+:uri-pkl-config-kotlin-main-sources: {uri-github-tree}/pkl-config-kotlin/src/main/kotlin/org/pkl/config/kotlin
-:uri-pkl-config-kotlin-test-sources: {uri-github-tree}/pkl-config-kotlin/src/test/kotlin/org/pkl/kotlin
+:uri-pkl-config-kotlin-test-sources: {uri-github-tree}/pkl-config-kotlin/src/test/kotlin/org/pkl/config/kotlin
 :uri-pkl-config-kotlin-ConverterFactories: {uri-pkl-config-kotlin-main-sources}/ConverterFactories.kt
 :uri-pkl-config-kotlin-ConfigExtensions: {uri-pkl-config-kotlin-main-sources}/ConfigExtensions.kt
 
@@ -20,36 +20,43 @@ To use the library in a Gradle project, declare the following dependency:
 
 [tabs]
 ====
-Groovy::
-+
-.build.gradle
-[source,groovy,subs="+attributes"]
-----
-dependencies {
-  compile "org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}"
-}
-
-ifndef::is-release-build[]
-repositories {
-  maven { url "{uri-sonatype}" }
-}
-endif::[]
-----
-
 Kotlin::
 +
 .build.gradle.kts
 [source,kotlin,subs="+attributes"]
 ----
 dependencies {
-  compile("org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}")
+  implementation("org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven(url = "{uri-sonatype}")
+endif::[]
+}
+----
+
+
+Groovy::
++
+.build.gradle
+[source,groovy,subs="+attributes"]
+----
+dependencies {
+  implementation "org.pkl-lang:pkl-config-kotlin:{pkl-artifact-version}"
+}
+
+repositories {
+ifdef::is-release-version[]
+  mavenCentral()
+endif::[]
+ifndef::is-release-version[]
+  maven { url "{uri-sonatype}" }
+endif::[]
+}
 ----
 ====
 
@@ -66,7 +73,7 @@ To use the library in a Maven project, declare the following dependency:
     <artifactId>pkl-config-kotlin</artifactId>
     <version>{pkl-artifact-version}</version>
   </dependency>
-ifndef::is-release-build[]
+ifndef::is-release-version[]
   <repositories>
     <repository>
       <id>sonatype-s01</id>

docs/modules/language-reference/pages/index.adoc

@@ -9,70 +9,6 @@ include::ROOT:partial$component-attributes.adoc[]
 :uri-javadoc-Pattern: https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html
 :uri-github-PklLexer: {uri-github-tree}/pkl-core/src/main/antlr/PklLexer.g4
 :uri-github-PklParser: {uri-github-tree}/pkl-core/src/main/antlr/PklParser.g4
-:uri-stdlib-baseModule: {uri-pkl-stdlib-docs}/base
-:uri-stdlib-jsonnetModule: {uri-pkl-stdlib-docs}/jsonnet
-:uri-stdlib-reflectModule: {uri-pkl-stdlib-docs}/reflect
-:uri-stdlib-xmlModule: {uri-pkl-stdlib-docs}/xml
-:uri-stdlib-protobufModule: {uri-pkl-stdlib-docs}/protobuf
-:uri-stdlib-Boolean: {uri-stdlib-baseModule}/Boolean
-:uri-stdlib-xor: {uri-stdlib-baseModule}/Boolean#xor()
-:uri-stdlib-implies: {uri-stdlib-baseModule}/Boolean#implies()
-:uri-stdlib-Any: {uri-stdlib-baseModule}/Any
-:uri-stdlib-String: {uri-stdlib-baseModule}/String
-:uri-stdlib-Int: {uri-stdlib-baseModule}/Int
-:uri-stdlib-Float: {uri-stdlib-baseModule}/Float
-:uri-stdlib-Number: {uri-stdlib-baseModule}/Number
-:uri-stdlib-NaN: {uri-stdlib-baseModule}/#NaN
-:uri-stdlib-Infinity: {uri-stdlib-baseModule}/#Infinity
-:uri-stdlib-isBetween: {uri-stdlib-baseModule}/Number#isBetween
-:uri-stdlib-isFinite: {uri-stdlib-baseModule}/Number#isFinite
-:uri-stdlib-Int8: {uri-stdlib-baseModule}/#Int8
-:uri-stdlib-Int16: {uri-stdlib-baseModule}/#Int16
-:uri-stdlib-Int32: {uri-stdlib-baseModule}/#Int32
-:uri-stdlib-UInt8: {uri-stdlib-baseModule}/#UInt8
-:uri-stdlib-UInt16: {uri-stdlib-baseModule}/#UInt16
-:uri-stdlib-UInt32: {uri-stdlib-baseModule}/#UInt32
-:uri-stdlib-UInt: {uri-stdlib-baseModule}/#UInt
-:uri-stdlib-Uri: {uri-stdlib-baseModule}/#Uri
-:uri-stdlib-matches: {uri-stdlib-baseModule}/String#matches()
-:uri-stdlib-Null: {uri-stdlib-baseModule}/Null
-:uri-stdlib-ifNonNull: {uri-stdlib-baseModule}/Null#ifNonNull()
-:uri-stdlib-List: {uri-stdlib-baseModule}/List
-:uri-stdlib-Set: {uri-stdlib-baseModule}/Set
-:uri-stdlib-Map: {uri-stdlib-baseModule}/Map
-:uri-stdlib-Listing: {uri-stdlib-baseModule}/Listing
-:uri-stdlib-Listing-default: {uri-stdlib-baseModule}/Listing#default
-:uri-stdlib-Listing-isDistinct: {uri-stdlib-baseModule}/Listing#isDistinct
-:uri-stdlib-Listing-isDistinctBy: {uri-stdlib-baseModule}/Listing#isDistinctBy()
-:uri-stdlib-Mapping: {uri-stdlib-baseModule}/Mapping
-:uri-stdlib-Mapping-default: {uri-stdlib-baseModule}/Mapping#default
-:uri-stdlib-Duration: {uri-stdlib-baseModule}/Duration
-:uri-stdlib-Duration-value: {uri-stdlib-baseModule}/Duration#value
-:uri-stdlib-Duration-unit: {uri-stdlib-baseModule}/Duration#unit
-:uri-stdlib-DurationUnit: {uri-stdlib-baseModule}/#DurationUnit
-:uri-stdlib-DataSize: {uri-stdlib-baseModule}/DataSize
-:uri-stdlib-DataSize-value: {uri-stdlib-baseModule}/DataSize#value
-:uri-stdlib-DataSize-unit: {uri-stdlib-baseModule}/DataSize#unit
-:uri-stdlib-DataSizeUnit: {uri-stdlib-baseModule}/#DataSizeUnit
-:uri-stdlib-Dynamic: {uri-stdlib-baseModule}/Dynamic
-:uri-stdlib-Dynamic-toTyped: {uri-stdlib-baseModule}/Dynamic#toTyped()
-:uri-stdlib-Typed: {uri-stdlib-baseModule}/Typed
-:uri-stdlib-Regex: {uri-stdlib-baseModule}/Regex
-:uri-stdlib-Regex-method: {uri-stdlib-baseModule}/#Regex()
-:uri-stdlib-Regex-match: {uri-stdlib-baseModule}/Regex#match
-:uri-stdlib-RegexMatch: {uri-stdlib-baseModule}/RegexMatch
-:uri-stdlib-ValueRenderer: {uri-stdlib-baseModule}/ValueRenderer
-:uri-stdlib-PcfRenderer-converters: {uri-stdlib-baseModule}/PcfRenderer#converters
-:uri-stdlib-Function: {uri-stdlib-baseModule}/Function
-:uri-stdlib-Function0: {uri-stdlib-baseModule}/Function0
-:uri-stdlib-Function1: {uri-stdlib-baseModule}/Function1
-:uri-stdlib-Function1-apply: {uri-stdlib-baseModule}/Function1#apply()
-:uri-stdlib-Function2: {uri-stdlib-baseModule}/Function2
-:uri-stdlib-Function3: {uri-stdlib-baseModule}/Function3
-:uri-stdlib-Function4: {uri-stdlib-baseModule}/Function4
-:uri-stdlib-Function5: {uri-stdlib-baseModule}/Function5
-:uri-stdlib-Resource: {uri-stdlib-baseModule}/Resource
-:uri-stdlib-outputFiles: {uri-stdlib-baseModule}/ModuleOutput#files
 :uri-pkl-core-ModuleSchema: {uri-pkl-core-main-sources}/ModuleSchema.java
 :uri-pkl-core-SecurityManager: {uri-pkl-core-main-sources}/SecurityManager.java
 :uri-pkl-core-ResourceReader: {uri-pkl-core-main-sources}/resource/ResourceReader.java
@@ -844,7 +780,7 @@ The resulting dynamic object is equivalent to `dodo`, except that it no longer h
 [IMPORTANT]
 .Lazy vs. Eager Data Types
 ====
-Converting an object to a map is a transitition from a _lazy_ to an _eager_ data type.
+Converting an object to a map is a transition from a _lazy_ to an _eager_ data type.
 All of the object's properties are evaluated and all references between them are resolved.
 
 If the map is later converted back to an object, subsequent changes to the object's properties no longer propagate to (previously) dependent properties.
@@ -991,6 +927,7 @@ class Bird {
 
 pigeon = new Bird { // <3>
   name = "Pigeon"
+  lifespan = 8
 }
 
 pigeonInIndex = pigeon.nameAndLifespanInIndex // <4>
@@ -1012,7 +949,7 @@ pigeon {
   lifespan = 8
   nameSignWidth = 9
 }
-pigeonInIndex = "Pigeon, 5"
+pigeonInIndex = "Pigeon, 8"
 pigeonDynamic {
   name = "Pigeon"
   lifespan = 8
@@ -1485,7 +1422,7 @@ reversedbirds = birds
 [IMPORTANT]
 .Lazy vs. Eager Data Types
 ====
-Converting a listing to a list is a transitition from a _lazy_ to an _eager_ data type.
+Converting a listing to a list is a transition from a _lazy_ to an _eager_ data type.
 All of the listing's elements are evaluated and all references between them are resolved.
 
 If the list is later converted back to a listing, subsequent changes to the listing's elements no longer propagate to (previously) dependent elements.
@@ -1865,7 +1802,7 @@ result = birds
 [IMPORTANT]
 .Lazy vs. Eager Data Types
 ====
-Converting a mapping to a map is a transitition from a _lazy_ to an _eager_ data type.
+Converting a mapping to a map is a transition from a _lazy_ to an _eager_ data type.
 All of the mapping's values are evaluated and all references between them are resolved.
 (Mapping keys are eagerly evaluated.)
 
@@ -2168,7 +2105,7 @@ A package is a shareable archive of modules and resources that are published to
 
 To import `package://example.com/mypackage@1.0.0#/my_module.pkl`, Pkl follows these steps:
 
-1. Make an HTTPS GET request to `https://example.com/mypackage@1.0.0` to retrieve the package's metadata.
+1. Make an HTTPS GET request to `\https://example.com/mypackage@1.0.0` to retrieve the package's metadata.
 2. From the package metadata, download the referenced zip archive, and validate its checksum.
 3. Resolve path `/my_module.pkl` within the package's zip archive.
 
@@ -2584,7 +2521,7 @@ This behavior is similar to the behavior of Bash with `shopt -s dotglob` enabled
 
 === Security Checks
 
-When attempting to directly evaluate a module, as in `pkl myModule.pkl`,
+When attempting to directly evaluate a module, as in `pkl eval myModule.pkl`,
 the following security checks are performed:
 
 * The module URI is checked against the module allowlist (`--allowed-modules`).
@@ -2637,7 +2574,7 @@ b {
 }
 ----
 
-`pkl config.pkl`, which is shorthand for `pkl --format pcf config.pkl`, renders the module as Pcf:
+`pkl eval config.pkl`, which is shorthand for `pkl eval --format pcf config.pkl`, renders the module as Pcf:
 
 [source,{pkl}]
 ----
@@ -2647,7 +2584,7 @@ b {
 }
 ----
 
-`pkl --format yaml config.pkl` renders the module as YAML:
+`pkl eval --format yaml config.pkl` renders the module as YAML:
 
 [source,yaml]
 ----
@@ -2656,7 +2593,7 @@ b:
   c: 20
 ----
 
-Likewise, `pkl --format json config.pkl` renders the module as JSON.
+Likewise, `pkl eval --format json config.pkl` renders the module as JSON.
 
 [[in-language]]
 ==== In-language
@@ -2812,7 +2749,7 @@ output {
 }
 ----
 
-Running `pkl -m output/ pigeon.pkl` produces the following output files:
+Running `pkl eval -m output/ birds.pkl` produces the following output files:
 
 .output/birds/pigeon.json
 [source,json]
@@ -3776,10 +3713,18 @@ The following class types are _generic types_:
 
 * `Pair`
 * `Collection`
+* `Listing`
 * `List`
+* `Mapping`
 * `Set`
 * `Map`
-* `Container`
+* `Function0`
+* `Function1`
+* `Function2`
+* `Function3`
+* `Function4`
+* `Function5`
+* `Class`
 
 A generic type has constituent types written in angle brackets (`<>`):
 
@@ -3790,7 +3735,7 @@ coll: Collection<Bird>      // <2>
 list: List<Bird>            // <3>
 set: Set<Bird>              // <4>
 map: Map<String, Bird>      // <5>
-cont: Mapping<String, Bird> // <6>
+mapping: Mapping<String, Bird> // <6>
 ----
 
 <1> a pair with first element of type `String` and second element of type `Bird`
@@ -3798,7 +3743,7 @@ cont: Mapping<String, Bird> // <6>
 <3> a list of `Bird` elements
 <4> a set of `Bird` elements
 <5> a map with `String` keys and `Bird` values
-<6> a container of `Bird` elements
+<6> a mapping of `String` keys and `Bird` values
 
 Omitting the constituent types is equivalent to declaring them as `unknown`:
 
@@ -3809,7 +3754,7 @@ coll: Collection // equivalent to `Collection<unknown>`
 list: List       // equivalent to `List<unknown>`
 set: Set         // equivalent to `Set<unknown>`
 map: Map         // equivalent to `Map<unknown, unknown>`
-cont: Mapping    // equivalent to `Mapping<unknown, unknown>`
+mapping: Mapping    // equivalent to `Mapping<unknown, unknown>`
 ----
 
 The `unknown` type is both a top and a bottom type.
@@ -3945,7 +3890,7 @@ nullish: Null                  // = null <11>
 <2> Properties of type `List` default to the empty list.
 <3> Properties of type `Set` default to the empty set.
 <4> Properties of type `Map` default to the empty map.
-<5> Properties of type `Listing<X>` default to an empty listing whose default element is the default for `Y`.
+<5> Properties of type `Listing<X>` default to an empty listing whose default element is the default for `X`.
 <6> Properties of type `Mapping<X, Y>` default to an empty mapping whose default value is the default for `Y`.
 <7> Properties of non-external class type `X` default to `new X {}`.
 <8> Properties of type `X?` default to `Null(x)` where `x` is the default for `X`.
@@ -5300,7 +5245,7 @@ package {
   name = "birds"
   baseUri = "package://example.com/birds"
   version = "1.8.3"
-  packageZipUrl = "https://example.com/birds@\(version).zip
+  packageZipUrl = "https://example.com/birds@\(version).zip"
 }
 ----
 <1> Specify relative project `../fruit` as a dependency.
@@ -5314,7 +5259,7 @@ package {
   name = "fruit"
   baseUri = "package://example.com/fruit"
   version = "1.5.0"
-  packageZipUrl = "https://example.com/fruit@\(version).zip
+  packageZipUrl = "https://example.com/fruit@\(version).zip"
 }
 ----
 

docs/modules/language-tutorial/pages/02_filling_out_a_template.adoc

@@ -39,7 +39,7 @@ When you run this, Pkl expands everything fully.
 [source,{pkl}]
 ----
 bird {
-  name = "Common wood pigeon"
+  name = "Pigeon"
   diet = "Seeds"
   taxonomy {
     kingdom = "Animalia"
@@ -220,12 +220,12 @@ import "pigeon.pkl" // <1>
 parrot = (pigeon) {
   name = "Great green macaw"
   diet = "Berries"
-  species {
+  taxonomy {
     species = "Ara ambiguus"
   }
 }
 ----
-<1> Importing `foo.pkl` creates the object `foo`, so you can refer to `pigeon` in this code, like you did before.
+<1> Importing `pigeon.pkl` creates the object `pigeon`, so you can refer to `pigeon` in this code, like you did before.
 
 If you run Pkl on both, you will see that it works.
 Looking at the result, however, you see a (possibly) unexpected difference.
@@ -233,7 +233,7 @@ Looking at the result, however, you see a (possibly) unexpected difference.
 [source,{pkl}]
 ----
 $ pkl eval /Users/me/tutorial/pigeon.pkl
-name = "Common wood pigeon""
+name = "Common wood pigeon"
 diet = "Seeds"
 taxonomy {
   species = "Columba palumbus"
@@ -372,11 +372,11 @@ pipelines {
 <1> There is no pipeline object to amend. The `new` keyword gives you an object to amend.
 
 So far, you've defined objects the same way you amended them.
-When the name `foo` didn't occur before, `foo { ... }` _creates_ a property called `foo` and assigns to it the object specified on the `...`.
+When the `name` didn't occur before, `new { ... }` _creates_ a property called `name` and assigns to it the object specified on the `Listing`.
-If `foo` is an existing object, this notation is an _amend expression_; resulting in a new _object_ (value), but _not_ a new (named) property.
+If `name` is an existing object, this notation is an _amend expression_; resulting in a new _object_ (value), but _not_ a new (named) property.
 Since `pipelines` is a listing, you can _add_ elements by writing expressions in an amend expression.
 
-In this case, though, there is no object to amend. Writing `myNewPipeline { ... }` defines a _property_, but listings may only include _elements_.
+In this case, though, there is no object to amend. Writing `pipelines { ... }` defines a _property_, but listings may only include _elements_.
 This is where you can use the keyword `new`.
 
 `new` gives you an object to amend.

docs/modules/language-tutorial/pages/03_writing_a_template.adoc

@@ -167,7 +167,7 @@ pklTutorialPart3 {
 
 ----
 
-Sadly, `pklTutorialParts.pkl` is a _rewrite_ of `pklTutorial.pkl`.
+Sadly, `pklTutorialParts.pkl` is a _rewrite_ of `pklTutorialPart3.pkl`.
 It creates a separate `class TutorialPart` and instantiates three properties with it (`pklTutorialPart1`, `pklTutorialPart2` and `pklTutorialPart3`).
 In doing so, it implicitly moves everything "down" one level (`pklTutorialPart3` is now a property in the module `pklTutorialParts`, whereas above, in `pklTutorialPart3.pkl` it was its own module).
 This is not very DRY.
@@ -256,13 +256,13 @@ By "precisely" we mean, that amending an object also can't "turn it into" an ins
 == A new template
 
 Now that you know about types, you can start writing your first template.
-So far, you've written configurations with Pkl, either without a template, or using a template on Pkl Hub.
+So far, you've written configurations with Pkl, either without a template, or using the `acmecicd` template from xref:02_filling_out_a_template.adoc#amending-templates[Amending templates].
 It is often easiest to first write a (typical) configuration for which you want to create a template.
 Suppose you want to define what a live workshop for this tutorial looks like.
 Consider this example:
 
 [source,{pkl}]
-.workshop2023.pkl
+.workshop2024.pkl
 ----
 title = "Pkl: Configure your Systems in New Ways"
 interactive = true
@@ -278,7 +278,7 @@ duration = 1.5.h
 
 event {
   name = "Migrating Birds between hemispheres"
-  year = 2023
+  year = 2024
 }
 
 instructors {
@@ -288,11 +288,11 @@ instructors {
 
 sessions {
   new {
-    date = "8/14/2023"
+    date = "2/1/2024"
     time = 30.min
   }
   new {
-    date = "8/15/2023"
+    date = "2/1/2024"
     time = 30.min
   }
 }
@@ -304,17 +304,17 @@ assistants {
 
 agenda {
   ["beginners"] {
-    title = "Basic Configuration"
+    name = "Basic Configuration"
     part = 1
     duration = 45.min
   }
   ["intermediates"] {
-    title = "Filling out a Template"
+    name = "Filling out a Template"
     part = 2
     duration = 45.min
   }
   ["experts"] {
-    title = "Writing a Template"
+    name = "Writing a Template"
     part = 3
     duration = 45.min
   }

docs/modules/pkl-cli/pages/index.adoc

@@ -1,11 +1,23 @@
 = CLI
 include::ROOT:partial$component-attributes.adoc[]
 :uri-homebrew: https://brew.sh
-:uri-pkl-macos-download: {github-releases}/pkl-cli-macos-{pkl-artifact-version}.bin
+
-:uri-pkl-linux-amd64-download: {github-releases}/pkl-cli-linux-amd64-{pkl-artifact-version}.bin
+:uri-pkl-macos-amd64-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-macos-amd64/{pkl-artifact-version}/pkl-cli-macos-amd64-{pkl-artifact-version}.bin
-:uri-pkl-linux-aarch64-download: {github-releases}/pkl-cli-linux-aarch64-{pkl-artifact-version}.bin
+:uri-pkl-macos-aarch64-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-macos-aarch64/{pkl-artifact-version}/pkl-cli-macos-aarch64-{pkl-artifact-version}.bin
-:uri-pkl-alpine-download: {github-releases}/pkl-cli-alpine-amd64-{pkl-artifact-version}.bin
+:uri-pkl-linux-amd64-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-linux-amd64/{pkl-artifact-version}/pkl-cli-linux-amd64-{pkl-artifact-version}.bin
-:uri-pkl-java-download: {github-releases}/pkl-cli-java-{pkl-artifact-version}.jar
+:uri-pkl-linux-aarch64-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-linux-aarch64/{pkl-artifact-version}/pkl-cli-linux-aarch64-{pkl-artifact-version}.bin
+:uri-pkl-alpine-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-alpine-linux-amd64/{pkl-artifact-version}/pkl-cli-alpine-linux-amd64-{pkl-artifact-version}.bin
+:uri-pkl-java-download: https://repo1.maven.org/maven2/org/pkl-lang/pkl-cli-java/{pkl-artifact-version}/pkl-cli-java-{pkl-artifact-version}.jar
+
+ifdef::is-release-version[]
+:uri-pkl-macos-amd64-download: {github-releases}/pkl-macos-amd64
+:uri-pkl-macos-aarch64-download: {github-releases}/pkl-macos-aarch64
+:uri-pkl-linux-amd64-download: {github-releases}/pkl-linux-amd64
+:uri-pkl-linux-aarch64-download: {github-releases}/pkl-linux-aarch64
+:uri-pkl-alpine-download: {github-releases}/pkl-alpine-linux-amd64
+:uri-pkl-java-download: {uri-maven-repo}/org/pkl-lang/pkl-cli-java/{pkl-artifact-version}/pkl-cli-java-{pkl-artifact-version}.jar
+endif::[]
+
 :uri-pkl-stdlib-docs-settings: {uri-pkl-stdlib-docs}/settings/
 :uri-pkl-cli-main-sources: {uri-github-tree}/pkl-cli/src/main/kotlin/org/pkl/cli
 :uri-pkl-cli-CliEvaluatorOptions: {uri-pkl-cli-main-sources}/CliEvaluatorOptions.kt
@@ -20,10 +32,10 @@ For interactive development, the CLI includes a Read-Eval-Print Loop (REPL).
 The CLI comes in multiple flavors:
 
 * Native macOS executable for amd64 (tested on macOS 10.15)
-* Native Linux executable for amd64 (tested on Oracle Linux 8)
+* Native Linux executable for amd64
-* Native Linux executable for aarch64 (tested on Oracle Linux 8)
+* Native Linux executable for aarch64
 * Native Alpine Linux executable for amd64 (cross-compiled and tested on Oracle Linux 8)
-* Java executable (tested with Java 8/11/14 on macOS and Oracle Linux)
+* Java executable (tested with Java 11/17 on macOS and Oracle Linux)
 
 On macOS and Linux, we recommend using the native executables.
 They are self-contained, start up instantly, and run complex Pkl code much faster than the Java executable.
@@ -36,38 +48,37 @@ whereas, the Alpine Linux executable is statically linked against _musl libc_ an
 ====
 
 The Java executable works on multiple platforms and has a smaller binary size than the native executables.
-However, it requires a Java 8 (or higher) runtime on the system path, has a noticeable startup delay,
+However, it requires a Java 11 (or higher) runtime on the system path, has a noticeable startup delay,
 and runs complex Pkl code slower than the native executables.
 
 All flavors are built from the same codebase and undergo the same automated testing.
 Except where noted otherwise, the rest of this page discusses the native executables.
 
-//TODO uncomment this after brew formula is merged and available
+[[homebrew]]
-// [[homebrew]]
+=== Homebrew
-// === Homebrew
+
-// 
+Release versions can be installed with {uri-homebrew}[Homebrew].
-// Release versions can be installed with {uri-homebrew}[Homebrew].
+
-// 
+ifdef::is-release-version[]
-// ifdef::is-release-version[]
+To install Pkl, run:
-// To install Pkl, run:
+
-// 
+[source,shell]
-// [source,shell]
+----
-// ----
+brew install pkl
-// brew install pkl
+----
-// ----
+
-// 
+To update Pkl, run:
-// To update Pkl, run:
+
-// 
+[source,shell]
-// [source,shell]
+----
-// ----
+brew update
-// brew update
+brew upgrade pkl   # or just `brew upgrade`
-// brew upgrade pkl   # or just `brew upgrade`
+----
-// ----
+endif::[]
-// endif::[]
+
-// 
+ifndef::is-release-version[]
-// ifndef::is-release-version[]
+For instructions, switch to a release version of this page.
-// For instructions, switch to a release version of this page.
+endif::[]
-// endif::[]
 
 [[download]]
 === Download
@@ -76,10 +87,22 @@ Development and release versions can be downloaded and installed manually.
 
 === macOS Executable
 
+On aarch64:
+
 [source,shell]
 [subs="+attributes"]
 ----
-curl -o pkl {uri-pkl-macos-download}
+curl -L -o pkl {uri-pkl-macos-aarch64-download}
+chmod +x pkl
+./pkl --version
+----
+
+On amd64:
+
+[source,shell]
+[subs="+attributes"]
+----
+curl -L -o pkl {uri-pkl-macos-amd64-download}
 chmod +x pkl
 ./pkl --version
 ----
@@ -98,23 +121,22 @@ Pkl {pkl-version} (macOS, native)
 The Linux executable is dynamically linked against _glibc_ and _libstdc{plus}{plus}_ for the amd64 and aarch64 architectures.
 For a statically linked executable, see <<Alpine Linux Executable>>.
 
-On amd64:
-
-[source,shell]
-[subs="+attributes"]
-----
-# on amd64
-curl -o pkl {uri-pkl-linux-amd64-download}
-chmod +x pkl
-./pkl --version
-----
-
 On aarch64:
 
 [source,shell]
 [subs="+attributes"]
 ----
-curl -o pkl {uri-pkl-linux-aarch64-download}
+curl -L -o pkl {uri-pkl-linux-aarch64-download}
+chmod +x pkl
+./pkl --version
+----
+
+On amd64:
+
+[source,shell]
+[subs="+attributes"]
+----
+curl -L -o pkl {uri-pkl-linux-amd64-download}
 chmod +x pkl
 ./pkl --version
 ----
@@ -136,7 +158,7 @@ For a dynamically linked executable, see <<Linux Executable>>.
 [source,shell]
 [subs="+attributes"]
 ----
-curl -o pkl {uri-pkl-alpine-download}
+curl -L -o pkl {uri-pkl-alpine-download}
 chmod +x pkl
 ./pkl --version
 ----
@@ -156,7 +178,7 @@ NOTE: We currently do not support the aarch64 architecture for Alpine Linux.
 [source,shell]
 [subs="+attributes"]
 ----
-curl -o jpkl {uri-pkl-java-download}
+curl -L -o jpkl {uri-pkl-java-download}
 chmod +x jpkl
 ./jpkl --version
 ----
@@ -319,7 +341,7 @@ The following command prints `Pigeon` to the console:
 
 [source,shell]
 ----
-pkl -x metadata.name pigeon.pkl
+pkl eval -x metadata.species pigeon.pkl
 # => Pigeon
 ----
 
@@ -333,7 +355,7 @@ metadata {
 }
 
 output {
-  text = metadata.name.toString()
+  text = metadata.species.toString()
 }
 ----
 ====
@@ -627,11 +649,11 @@ To load <<config.pkl,`config.pkl`>> into the REPL, run:
 pkl> :load config.pkl
 ----
 
-To evaluate the `bird.name` property, run:
+To evaluate the `bird.species` property, run:
 
 [source,shell]
 ----
-pkl> bird.name
+pkl> bird.species
 "Pigeon"
 ----
 
@@ -693,7 +715,7 @@ pkl> hello
 pkl> function double(n) = 2 * n
 pkl> double(5)
 10
-pkl> class Bird { name: String }
+pkl> class Bird { species: String }
 pkl> new Bird { species = "Pigeon" }
 {
   name = ?
@@ -715,9 +737,9 @@ pkl> species
 pkl> species = "Barn"
 pkl> species
 "Barn"
-pkl> species += " Owl"
+pkl> species + " Owl"
 pkl> species
-"Barn owl"
+"Barn Owl"
 ----
 
 Due to Pkl's late binding semantics, redefining a member affects dependent members:
@@ -725,9 +747,9 @@ Due to Pkl's late binding semantics, redefining a member affects dependent membe
 [source,shell]
 ----
 pkl> name = "Barn"
-pkl> species = "$name Owl"
+pkl> species = "\(name) Owl"
 pkl> species
-"Barn owl"
+"Barn Owl"
 pkl> name = "Elf"
 pkl> species
 "Elf Owl"

docs/modules/pkl-core/pages/index.adoc

@@ -2,7 +2,7 @@
 include::ROOT:partial$component-attributes.adoc[]
 :uri-pkl-core-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-core
 :uri-pkl-core-main-sources: {uri-github-tree}/pkl-core/src/main/java/org/pkl/core
-:uri-pkl-core-test-sources: {uri-github-tree}/pkl-core/src/test/java/org/pkl/core
+:uri-pkl-core-test-sources: {uri-github-tree}/pkl-core/src/test/kotlin/org/pkl/core
 :uri-pkl-core-Evaluator: {uri-pkl-core-main-sources}/Evaluator.java
 :uri-pkl-core-PModule: {uri-pkl-core-main-sources}/PModule.java
 :uri-pkl-core-PklException: {uri-pkl-core-main-sources}/PklException.java
@@ -39,11 +39,14 @@ dependencies {
   compile "org.pkl-lang:pkl-core:{pkl-artifact-version}"
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url "{uri-sonatype}" }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url "{uri-sonatype}" }
+endif::[]
+}
 ----
 
 Kotlin::
@@ -55,11 +58,14 @@ dependencies {
   compile("org.pkl-lang:pkl-core:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url = uri("{uri-sonatype}") }
+endif::[]
+}
 ----
 ====
 
@@ -76,7 +82,7 @@ To use the library in a Maven project, declare the following dependency:
     <artifactId>pkl-core</artifactId>
     <version>{pkl-artifact-version}</version>
   </dependency>
-ifndef::is-release-build[]
+ifndef::is-release-version[]
   <repositories>
     <repository>
       <id>sonatype-s01</id>

docs/modules/pkl-doc/pages/index.adoc

@@ -95,11 +95,14 @@ dependencies {
   compile "org.pkl-lang:pkl-doc:{pkl-artifact-version}"
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url "{uri-sonatype}" }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url "{uri-sonatype}" }
+endif::[]
+}
 ----
 
 Kotlin::
@@ -111,11 +114,14 @@ dependencies {
   compile("org.pkl-lang:pkl-doc:{pkl-artifact-version}")
 }
 
-ifndef::is-release-build[]
 repositories {
-  maven { url = uri("{uri-sonatype}") }
+ifdef::is-release-version[]
-}
+  mavenCentral()
 endif::[]
+ifndef::is-release-version[]
+  maven { url = uri("{uri-sonatype}") }
+endif::[]
+}
 ----
 ====
 
@@ -132,7 +138,7 @@ To use the library in a Maven project, declare the following dependency:
     <artifactId>pkl-doc</artifactId>
     <version>{pkl-artifact-version}</version>
   </dependency>
-ifndef::is-release-build[]
+ifndef::is-release-version[]
   <repositories>
     <repository>
       <id>sonatype-s01</id>

docs/modules/pkl-gradle/pages/index.adoc

@@ -47,10 +47,10 @@ plugins {
 ----
 pluginManagement {
     repositories {
-ifdef::is-release-build[]
+ifdef::is-release-version[]
         mavenCentral()
 endif::[]
-ifndef::is-release-build[]
+ifndef::is-release-version[]
         maven { url "{uri-sonatype}" }
 endif::[]
     }
@@ -72,10 +72,10 @@ plugins {
 ----
 pluginManagement {
     repositories {
-ifdef::is-release-build[]
+ifdef::is-release-version[]
         mavenCentral()
 endif::[]
-ifndef::is-release-build[]
+ifndef::is-release-version[]
         maven { url = uri("{uri-sonatype}") }
 endif::[]
     }

docs/modules/release-notes/pages/0.25.adoc

@@ -1,8 +1,11 @@
 = Pkl 0.25 Release Notes
 :version: 0.25
-:version-minor: 0.25.0
+:version-minor: 0.25.3
 :release-date: February 1st, 2024
 
-This is the first release of Pkl!
+Pkl {version} was released on {release-date}. +
+[.small]#The latest bugfix release is {version-minor}. (xref:changelog.adoc[All Versions])#
 
-To learn more, refer to our xref:blog:introducing-pkl.adoc[blog post].
+This is the initial release of Pkl, a programming language for creating configuration.
+
+To learn more about Pkl, refer to our xref:blog:ROOT:introducing-pkl.adoc[blog post].

docs/modules/release-notes/pages/changelog.adoc

@@ -1,8 +1,82 @@
 = Changelog
 include::ROOT:partial$component-attributes.adoc[]
 
+[[release-0.25.3]]
+== 0.25.3 (2024-03-26)
+
+=== Fixes
+
+* Fixes some issues with generated pkldoc websites (link:https://github.com/apple/pkl/pull/357[#357], link:https://github.com/apple/pkl/pull/362[#362])
+* Fixes a bug where amending a module that defines an abstract class might cause a Java `AssertionError` (link:https://github.com/apple/pkl/pull/319[#319])
+* Fixes a bug where a for/when generator within a lambda declared with `new {}` syntax might not resolve variables correctly (link:https://github.com/apple/pkl/pull/297[#297])
+* Fixes a bug where `const` and `local` modifiers are not exported when obtaining a class's mirror in `pkl:reflect` (link:https://github.com/apple/pkl/pull/265[#265]).
+
+=== Miscellaneous
+
+* Documentation improvements (link:https://github.com/apple/pkl/pull/93[#93], link:https://github.com/apple/pkl/pull/106[#106], link:https://github.com/apple/pkl/pull/143[#143], link:https://github.com/apple/pkl/pull/205[#205], link:https://github.com/apple/pkl/pull/214[#214], link:https://github.com/apple/pkl/pull/224[#224], link:https://github.com/apple/pkl/pull/257[#257], link:https://github.com/apple/pkl/pull/270[#270], link:https://github.com/apple/pkl/pull/282[#282], link:https://github.com/apple/pkl/pull/283[#283], link:https://github.com/apple/pkl/pull/299[#299], link:https://github.com/apple/pkl/pull/337[#337], link:https://github.com/apple/pkl/pull/340[#340])
+* Build script improvements (link:https://github.com/apple/pkl/pull/253[#253], link:https://github.com/apple/pkl/pull/314[#314], link:https://github.com/apple/pkl/pull/333[#333], link:https://github.com/apple/pkl/pull/338[#338])
+
+=== Changes
+
+* Add `jpkl` to the set of artifacts released to GitHub (link:https://github.com/apple/pkl/pull/314[#314])
+
+=== Contributors ❤️
+
+Thank you to all the contributors for this release!
+
+* link:https://github.com/r1ft1[@r1ft1]
+* link:https://github.com/WardsParadox[@WardsParadox]
+* link:https://github.com/grantabbott[@grantabbott]
+* link:https://github.com/mshakhmaykin[@mshakhmaykin]
+* link:https://github.com/d4wae89d498[@d4wae89d498]
+* link:https://github.com/KushalP[@KushalP]
+* link:https://github.com/zihluwang[@zihluwang]
+* link:https://github.com/Malix-off[@Malix-off]
+
+[[release-0.25.2]]
+== 0.25.2 (2024-02-08)
+
+=== Fixes
+
+* Fixes some issues with generated pkldoc websites (link:https://github.com/apple/pkl/pull/70[#70],
+link:https://github.com/apple/pkl/pull/81[#81], link:https://github.com/apple/pkl/pull/96[#96])
+* Fixes an issue where a PklBugException produces an incorrect URL to file issues (link:https://github.com/apple/pkl/pull/73[#73])
+
+=== Miscellaneous
+
+* Documentation fixes (link:https://github.com/apple/pkl/pull/21[#21], link:https://github.com/apple/pkl/pull/29[#29], link:https://github.com/apple/pkl/pull/41[#41], link:https://github.com/apple/pkl/pull/44[#44], link:https://github.com/apple/pkl/pull/51[#51], link:https://github.com/apple/pkl/pull/57[#57], link:https://github.com/apple/pkl/pull/60[#60], link:https://github.com/apple/pkl/pull/64[#64], link:https://github.com/apple/pkl/pull/68[#68], link:https://github.com/apple/pkl/pull/74[#74], link:https://github.com/apple/pkl/pull/77[#77], link:https://github.com/apple/pkl/pull/78[#78], link:https://github.com/apple/pkl/pull/82[#82], link:https://github.com/apple/pkl/pull/84[#84], link:https://github.com/apple/pkl/pull/86[#86], link:https://github.com/apple/pkl/pull/89[#89], link:https://github.com/apple/pkl/pull/91[#91], link:https://github.com/apple/pkl/pull/104[#104])
+* Build script improvements (https://github.com/apple/pkl/pull/53[#53], link:https://github.com/apple/pkl/pull/83[#83])
+
+=== Contributors ❤️
+
+Thank you to all the contributors for this release!
+
+* link:https://github.com/uhooi[@uhooi]
+* link:https://github.com/mnin[@mnin]
+* link:https://github.com/TinkoLiu[@TinkoLiu]
+* link:https://github.com/shufanhao[@shufanhao]
+* link:https://github.com/pfeilbr[@pfeilbr]
+* link:https://github.com/KadoBOT[@KadoBOT]
+* link:https://github.com/KushalP[@KushalP]
+* link:https://github.com/translatenix[@translatenix]
+* link:https://github.com/Edward-Knight[@Edward-Knight]
+* link:https://github.com/jamesward[@jamesward]
+* link:https://github.com/shubhgng[@shubhgng]
+* link:https://github.com/hayashikun[@hayashikun]
+* link:https://github.com/lanzafame[@lanzafame]
+* link:https://github.com/igmrrf[@igmrrf]
+* link:https://github.com/kelvinelove[@kelvinelove]
+* link:https://github.com/lilyball[@lilyball]
+* link:https://github.com/maiph[@maiph]
+
+[[release-0.25.1]]
+== 0.25.1 (2024-02-01)
+
+=== Fixes
+
+* Fixes an issue where pkl-tools fat jar is empty.
+
 [[release-0.25.0]]
 == 0.25.0 (2024-02-01)
 
 xref:0.25.adoc[Release notes]
-

docs/nav.adoc

@@ -1,19 +1,31 @@
-* xref:pkl-cli:index.adoc#installation[Installation]
-* xref:language-tutorial:index.adoc[Tutorial]
-** xref:language-tutorial:01_basic_config.adoc[Basic Configuration]
-** xref:language-tutorial:02_filling_out_a_template.adoc[Filling out a Template]
-** xref:language-tutorial:03_writing_a_template.adoc[Writing a Template]
-* xref:language-reference:index.adoc[Language Reference]
-
 * xref:introduction:index.adoc[Introduction]
 ** xref:introduction:use-cases.adoc[Use Cases]
 ** xref:introduction:concepts.adoc[Concepts]
 ** xref:introduction:comparison.adoc[Comparison]
 
+* xref:pkl-cli:index.adoc#installation[Installation]
+
+* xref:language-tutorial:index.adoc[Tutorial]
+** xref:language-tutorial:01_basic_config.adoc[Basic Configuration]
+** xref:language-tutorial:02_filling_out_a_template.adoc[Filling out a Template]
+** xref:language-tutorial:03_writing_a_template.adoc[Writing a Template]
+
 * xref:ROOT:language.adoc[Language]
-** xref:language-tutorial:index.adoc[Tutorial]
 ** xref:language-reference:index.adoc[Language Reference]
 ** xref:ROOT:standard-library.adoc[Standard Library]
+** xref:ROOT:language-bindings.adoc[Language Bindings]
+*** xref:java-binding:index.adoc[Java]
+**** xref:java-binding:codegen.adoc[Code Generator]
+**** xref:pkl-core:index.adoc[pkl-core Library]
+**** xref:java-binding:pkl-config-java.adoc[pkl-config-java Library]
+*** xref:kotlin-binding:index.adoc[Kotlin]
+**** xref:kotlin-binding:codegen.adoc[Code Generator]
+**** xref:kotlin-binding:pkl-config-kotlin.adoc[pkl-config-kotlin Library]
+*** xref:swift:ROOT:index.adoc[Swift]
+*** xref:go:ROOT:index.adoc[Go]
+*** xref:bindings-specification:index.adoc[Specification]
+**** xref:bindings-specification:message-passing-api.adoc[Message Passing API]
+**** xref:bindings-specification:binary-encoding.adoc[Pkl Binary Encoding]
 
 * xref:ROOT:tools.adoc[Tools]
 ** xref:pkl-cli:index.adoc[CLI]
@@ -24,21 +36,9 @@
 *** xref:vscode:ROOT:index.adoc[VSCode]
 *** xref:neovim:ROOT:index.adoc[Neovim]
 
-* xref:ROOT:language-bindings.adoc[Language Bindings]
-** xref:java-binding:index.adoc[Java]
-*** xref:java-binding:codegen.adoc[Code Generator]
-*** xref:pkl-core:index.adoc[pkl-core Library]
-*** xref:java-binding:pkl-config-java.adoc[pkl-config-java Library]
-
-** xref:kotlin-binding:index.adoc[Kotlin]
-*** xref:kotlin-binding:codegen.adoc[Code Generator]
-*** xref:kotlin-binding:pkl-config-kotlin.adoc[pkl-config-kotlin Library]
-
-** xref:swift:ROOT:index.adoc[Swift]
-** xref:go:ROOT:index.adoc[Go]
-
 * xref:ROOT:examples.adoc[Examples]
 
 * xref:release-notes:index.adoc[Release Notes]
 ** xref:release-notes:0.25.adoc[0.25 Release Notes]
 ** xref:release-notes:changelog.adoc[Changelog]
+

gradle.properties

@@ -1,7 +1,7 @@
 # suppress inspection "UnusedProperty" for whole file
 
 group=org.pkl-lang
-version=0.25.0
+version=0.25.3
 
 # google-java-format requires jdk.compiler exports
 org.gradle.jvmargs= \

pkl-cli/pkl-cli.gradle.kts

@@ -254,7 +254,7 @@ val linuxExecutableAarch64: TaskProvider<Exec> by tasks.registering(Exec::class)
  */
 val alpineExecutableAmd64: TaskProvider<Exec> by tasks.registering(Exec::class) {
   configureExecutable(
-      buildInfo.os.isLinux && buildInfo.arch == "amd64",
+      buildInfo.os.isLinux && buildInfo.arch == "amd64" && buildInfo.hasMuslToolchain,
       file("$buildDir/executable/pkl-alpine-linux-amd64"),
       listOf(
         "--static",

pkl-core/pkl-core.gradle.kts

@@ -256,7 +256,7 @@ val testLinuxExecutableAarch64 by tasks.registering(Test::class) {
 }
 
 val testAlpineExecutableAmd64 by tasks.registering(Test::class) {
-  enabled = buildInfo.os.isLinux && buildInfo.arch == "amd64"
+  enabled = buildInfo.os.isLinux && buildInfo.arch == "amd64" && buildInfo.hasMuslToolchain
   dependsOn(":pkl-cli:alpineExecutableAmd64")
 
   inputs.dir("src/test/files/LanguageSnippetTests/input")

pkl-core/src/main/java/org/pkl/core/PklInfo.java

@@ -17,7 +17,7 @@ package org.pkl.core;
 
 /** Information about the Pkl package index. */
 public final class PklInfo {
-  private static final String PACKAGE_INDEX_HOMEPAGE = "https://pkl-lang.org/package-docs";
+  private static final String PACKAGE_INDEX_HOMEPAGE = "https://pkl-lang.org/package-docs/";
 
   private static final PklInfo CURRENT;
   private final PackageIndex packageIndex;

pkl-core/src/main/java/org/pkl/core/ast/VmModifier.java

@@ -72,6 +72,14 @@ public final class VmModifier {
 
   public static final int VALID_OBJECT_MEMBER_MODIFIERS = LOCAL;
 
+  public static final int TYPEALIAS_OBJECT_MEMBER = TYPE_ALIAS | CONST;
+
+  public static final int LOCAL_TYPEALIAS_OBJECT_MEMBER = LOCAL | TYPEALIAS_OBJECT_MEMBER;
+
+  public static final int CLASS_OBJECT_MEMBER = CLASS | CONST;
+
+  public static final int LOCAL_CLASS_OBJECT_MEMBER = LOCAL | CLASS_OBJECT_MEMBER;
+
   public static boolean isLocal(int modifiers) {
     return (modifiers & LOCAL) != 0;
   }
@@ -164,6 +172,10 @@ public final class VmModifier {
         return "hidden";
       case EXTERNAL:
         return "external";
+      case FIXED:
+        return "fixed";
+      case CONST:
+        return "const";
       default:
         throw new VmExceptionBuilder()
             .bug("Cannot convert internal modifier `%s` to a string.", toString(modifier))
@@ -179,6 +191,8 @@ public final class VmModifier {
     if (isHidden(modifiers)) builder.add(toString(HIDDEN));
     // `external` modifier is part of class contract but not part of property/method contract
     if (isExternal(modifiers) && isClass) builder.add(toString(EXTERNAL));
+    if (isFixed(modifiers)) builder.add(toString(FIXED));
+    if (isConst(modifiers)) builder.add(toString(CONST));
 
     return builder.build();
   }

pkl-core/src/main/java/org/pkl/core/ast/builder/AstBuilder.java

@@ -305,11 +305,13 @@ public final class AstBuilder extends AbstractAstBuilder<Object> {
                   doVisitClassProperties(propertyCtxs, propertyNames),
                   doVisitMethodDefs(methodCtxs));
 
+          var isLocal = VmModifier.isLocal(modifiers);
+
           var result =
               new ObjectMember(
                   sourceSection,
                   headerSection,
-                  modifiers | VmModifier.CONST,
+                  isLocal ? VmModifier.LOCAL_CLASS_OBJECT_MEMBER : VmModifier.CLASS_OBJECT_MEMBER,
                   scope.getName(),
                   scope.getQualifiedName());
 
@@ -360,7 +362,9 @@ public final class AstBuilder extends AbstractAstBuilder<Object> {
               new ObjectMember(
                   sourceSection,
                   headerSection,
-                  modifiers | VmModifier.CONST,
+                  isLocal
+                      ? VmModifier.LOCAL_TYPEALIAS_OBJECT_MEMBER
+                      : VmModifier.TYPEALIAS_OBJECT_MEMBER,
                   scopeName,
                   scope.getQualifiedName());
 

pkl-core/src/main/java/org/pkl/core/ast/expression/literal/AmendFunctionNode.java

@@ -61,6 +61,7 @@ public final class AmendFunctionNode extends PklNode {
     } else {
       parameterSlots = new int[0];
     }
+    var hasForGenVars = false;
     for (var i = 0; i < hostFrameDesecriptor.getNumberOfSlots(); i++) {
       var slotInfo = hostFrameDesecriptor.getSlotInfo(i);
       // Copy for-generator variables from the outer frame descriptor into inner lambda.
@@ -74,10 +75,22 @@ public final class AmendFunctionNode extends PklNode {
       // frame (e.g. with `new Mixin { ... }` syntax), so it injects for-generator vars into the
       // wrong frame.
       //
-      // As a remedy, we simply copy outer for-generator variables into this frame.
+      // As a remedy, we simply copy outer variables into this frame if there are any for generator
+      // variables.
+      //
+      // We need to preserve the frame slot index, so we insert dummy identifiers
+      // for other slots that aren't for generator variables.
       if (slotInfo != null && slotInfo.equals(SymbolTable.FOR_GENERATOR_VARIABLE)) {
+        if (!hasForGenVars) {
+          hasForGenVars = true;
+          for (var j = 0; j < i; j++) {
+            builder.addSlot(FrameSlotKind.Illegal, Identifier.DUMMY, null);
+          }
+        }
         builder.addSlot(
             hostFrameDesecriptor.getSlotKind(i), hostFrameDesecriptor.getSlotName(i), null);
+      } else if (hasForGenVars) {
+        builder.addSlot(FrameSlotKind.Illegal, Identifier.DUMMY, null);
       }
     }
     var objectToAmendSlot = builder.addSlot(FrameSlotKind.Object, new Object(), null);

pkl-core/src/main/java/org/pkl/core/runtime/Identifier.java

@@ -152,6 +152,9 @@ public final class Identifier implements Comparable<Identifier> {
   // common in lambdas etc
   public static final Identifier IT = get("it");
 
+  // dummy, unrepresentable identifier
+  public static final Identifier DUMMY = get("`#_");
+
   private final String name;
 
   private Identifier(String name) {

pkl-core/src/main/java/org/pkl/core/runtime/VmExceptionRenderer.java

@@ -59,7 +59,7 @@ public class VmExceptionRenderer {
         .append("Cmd+Double-click the link below to open an issue.\n")
         .append(
             "Please copy and paste the entire error output into the issue's description, provided you can share it.\n\n")
-        .append("https://github.com/apple/pkl/issues/new");
+        .append("https://github.com/apple/pkl/issues/new\n\n");
 
     builder.append(
         URLEncoder.encode(exceptionToReport.toString(), StandardCharsets.UTF_8)

pkl-core/src/main/java/org/pkl/core/runtime/VmLanguage.java

@@ -35,7 +35,7 @@ import org.pkl.core.util.Nullable;
 @TruffleLanguage.Registration(
     id = "pkl",
     name = "Pkl",
-    version = "0.25.0",
+    version = "0.25.3",
     characterMimeTypes = VmLanguage.MIME_TYPE,
     contextPolicy = ContextPolicy.SHARED)
 public final class VmLanguage extends TruffleLanguage<VmContext> {

pkl-core/src/main/java/org/pkl/core/util/IoUtils.java

@@ -365,13 +365,13 @@ public final class IoUtils {
       return uri;
     }
 
-    var basePath = Path.of(base.getRawPath());
+    var basePath = Path.of(base.getPath());
     if (!base.getRawPath().endsWith("/")) basePath = basePath.getParent();
-    var resultPath = basePath.relativize(Path.of(uri.getRawPath()));
+    var resultPath = basePath.relativize(Path.of(uri.getPath()));
 
     try {
       return new URI(
-          null, null, null, -1, resultPath.toString(), uri.getRawQuery(), uri.getRawFragment());
+          null, null, null, -1, resultPath.toString(), uri.getQuery(), uri.getFragment());
     } catch (URISyntaxException e) {
       throw new IllegalArgumentException(e);
     }

pkl-core/src/test/files/LanguageSnippetTests/input-helper/api/reflect/BaseModule.pkl

@@ -49,6 +49,10 @@ stringLiteral: "yes"
 constrained: String(length.isBetween(3, 10))
 aliased: MyMap<Person>
 
+hidden hiddenProp: String
+const constProp: String = "the const prop"
+fixed fixedProp: String = "the fixed prop"
+
 /// class doc comment
 @MyAnn { text = "class annotation" }
 open class Person {

pkl-core/src/test/files/LanguageSnippetTests/input-helper/modules/Birds.pkl

@@ -0,0 +1,12 @@
+module Birds
+
+abstract class Bird {
+  name: String
+}
+
+class Pigeon extends Bird {
+  name = "Pigeon"
+  passenger: Boolean
+}
+
+pidgy: Pigeon?

pkl-core/src/test/files/LanguageSnippetTests/input/api/reflect1.pkl

@@ -152,6 +152,9 @@ examples {
     personClassProperties.keys
     testHelpers.property(personClassProperties["name"], reflect.stringType)
     testHelpers.property(personClassProperties["age"], reflect.intType)
+    modClassProps["hiddenProp"].modifiers
+    modClassProps["constProp"].modifiers
+    modClassProps["fixedProp"].modifiers
   }
 
   ["Reflected class methods metadata"] {

pkl-core/src/test/files/LanguageSnippetTests/input/generators/forGeneratorInMixins.pkl

@@ -38,3 +38,13 @@ function mapEnvLiteral(_env: Dynamic) = (it) -> (it) {
     }
   }
 }
+
+function addElements(keys: List<String>): Mixin<Mapping<String, String>> = new {
+  for (key in keys) {
+    [key] = key
+  }
+}
+
+res = new Mapping<String, String> {
+  ["base"] = "alreadyThere"
+} |> addElements(List("newElement"))

pkl-core/src/test/files/LanguageSnippetTests/input/modules/amendModule6.pkl

@@ -0,0 +1 @@
+amends ".../input-helper/modules/Birds.pkl"

pkl-core/src/test/files/LanguageSnippetTests/output/api/reflect1.pcf

@@ -67,7 +67,7 @@ facts {
 }
 examples {
   ["Reflected module properties of unknown type metadata"] {
-    Set("int", "float", "string", "boolean", "duration", "dataSize", "pair", "list", "set", "map", "listing", "mapping", "dynamic", "typed", "int2", "float2", "string2", "boolean2", "duration2", "dataSize2", "pair2", "list2", "set2", "map2", "listing2", "mapping2", "dynamic2", "typed2", "any", "noth", "unkn", "union", "nullable", "stringLiteral", "constrained", "aliased")
+    Set("int", "float", "string", "boolean", "duration", "dataSize", "pair", "list", "set", "map", "listing", "mapping", "dynamic", "typed", "int2", "float2", "string2", "boolean2", "duration2", "dataSize2", "pair2", "list2", "set2", "map2", "listing2", "mapping2", "dynamic2", "typed2", "any", "noth", "unkn", "union", "nullable", "stringLiteral", "constrained", "aliased", "hiddenProp", "constProp", "fixedProp")
     new {
       hasExpectedLocation = true
       docComment = "module property doc comment"
@@ -373,6 +373,9 @@ examples {
       defaultValue = 42
       hasExpectedType = true
     }
+    Set("hidden")
+    Set("const")
+    Set("fixed")
   }
   ["Reflected class methods metadata"] {
     Set("sing")

pkl-core/src/test/files/LanguageSnippetTests/output/generators/forGeneratorInMixins.pcf

@@ -36,3 +36,7 @@ foo {
     }
   }
 }
+res {
+  ["base"] = "alreadyThere"
+  ["newElement"] = "newElement"
+}

pkl-core/src/test/files/LanguageSnippetTests/output/modules/amendModule6.pcf

@@ -0,0 +1 @@
+pidgy = null

pkl-core/src/test/kotlin/org/pkl/core/runtime/DefaultModuleResolverTest.kt

@@ -163,7 +163,7 @@
 //            Arrays.asList("file:///pkl/.*", "https://.*\\.apple\\.com"));
 //
 //    resolver.resolve("file:///pkl/foo.pkl", fileUrlModule, sourceSection);
-//    resolver.resolve("https://pkl.io/foo.pkl", fileUrlModule, sourceSection);
+//    resolver.resolve("https://example.com/foo.pkl", fileUrlModule, sourceSection);
 //  }
 //
 //  @Test(expected = EvalException.class)

pkl-doc/src/main/kotlin/org/pkl/doc/ClassPageGenerator.kt

@@ -41,7 +41,7 @@ internal class ClassPageGenerator(
 
         h1 {
           id = "declaration-title"
-          +clazz.simpleName
+          +clazz.simpleName.asIdentifier
 
           span {
             id = "declaration-version"
@@ -98,7 +98,7 @@ internal class ClassPageGenerator(
             span {
               classes = setOf("name-decl")
 
-              +clazz.simpleName
+              +clazz.simpleName.asIdentifier
             }
 
             renderTypeParameters(clazz.typeParameters)
@@ -116,7 +116,7 @@ internal class ClassPageGenerator(
   }
 
   // example output:
-  // class HostAlias (io.k8s/api/core/v1/PodSpec:befa7c51) • Pkl Hub
+  // HostAlias (pkg.pkl-lang.org/pkl-k8s/k8s@1.0.0) • Package Docs
   override fun HTMLTag.renderPageTitle() {
     val classScope = pageScope
     val moduleScope = classScope.parent!!

pkl-doc/src/main/kotlin/org/pkl/doc/DocGenerator.kt

@@ -23,7 +23,6 @@ import kotlin.io.path.deleteIfExists
 import kotlin.io.path.exists
 import kotlin.io.path.isSameFileAs
 import org.pkl.commons.deleteRecursively
-import org.pkl.commons.toUri
 import org.pkl.core.ModuleSchema
 import org.pkl.core.PClassInfo
 import org.pkl.core.Version
@@ -180,7 +179,7 @@ internal class DocPackage(val docPackageInfo: DocPackageInfo, val modules: List<
         mod,
         docPackageInfo.version,
         docPackageInfo.getModuleImportUri(mod.moduleName),
-        docPackageInfo.getModuleSourceCode(mod.moduleName)?.toUri(),
+        docPackageInfo.getModuleSourceCode(mod.moduleName),
         exampleModulesBySubject[mod.moduleName] ?: listOf()
       )
     }

pkl-doc/src/main/kotlin/org/pkl/doc/DocPackageInfo.kt

@@ -159,18 +159,18 @@ data class DocPackageInfo(
   internal fun getModuleImportUri(moduleName: String): URI =
     when (importUri) {
       "pkl:/" -> "pkl:${moduleName.substring(4)}".toUri()
-      else -> "$importUri${getModulePath(moduleName, moduleNamePrefix)}.pkl".toUri()
+      else -> {
+        val path = getModulePath(moduleName, moduleNamePrefix).uriEncoded + ".pkl"
+        URI(importUri + path)
+      }
     }
 
-  internal fun getModuleSourceCode(moduleName: String): String? {
+  internal fun getModuleSourceCode(moduleName: String): URI? {
-    val path = "/" + getModulePath(moduleName, moduleNamePrefix) + ".pkl"
+    val path = "/" + getModulePath(moduleName, moduleNamePrefix).uriEncoded + ".pkl"
     // assumption: the fragment is only used for line numbers
-    return sourceCodeUrlScheme?.replace("%{path}", path)?.substringBefore('#')
+    return sourceCodeUrlScheme?.replace("%{path}", path)?.substringBefore('#')?.let(URI::create)
   }
 
-  private fun getModulePath(moduleName: String, packagePrefix: String): String =
-    moduleName.substring(packagePrefix.length).replace('.', '/')
-
   /** Information about a depended-on package. */
   data class PackageDependency(
     /** The name of the depended-on package. */

pkl-doc/src/main/kotlin/org/pkl/doc/DocScope.kt

@@ -253,9 +253,7 @@ internal class PackageScope(
   private val moduleScopes: Map<String, ModuleScope> by lazy {
     modules.associate { module ->
       val docUrl =
-        url.resolve(
+        url.resolve(getModulePath(module.moduleName, modulePrefix).uriEncoded + "/index.html")
-          "${module.moduleName.substring(modulePrefix.length).replace('.', '/')}/index.html"
-        )
       module.moduleName to ModuleScope(module, docUrl, this)
     }
   }
@@ -328,7 +326,7 @@ internal class ModuleScope(
     get() = module.moduleName
 
   val path: String by lazy {
-    name.substring(parent!!.docPackageInfo.moduleNamePrefix.length).replace('.', '/')
+    getModulePath(module.moduleName, parent!!.docPackageInfo.moduleNamePrefix).uriEncoded
   }
 
   override val dataUrl: URI by lazy { parent!!.dataUrl.resolve("./$path/index.js") }
@@ -388,10 +386,13 @@ internal class ClassScope(
 ) : PageScope() {
   override val url: URI by lazy {
     // `isModuleClass` distinction is relevant when this scope is a link target
-    if (clazz.isModuleClass) parentUrl else parentUrl.resolve("${clazz.simpleName}.html")
+    if (clazz.isModuleClass) parentUrl
+    else parentUrl.resolve("${clazz.simpleName.uriEncodedComponent}.html")
   }
 
-  override val dataUrl: URI by lazy { parent!!.dataUrl.resolve("${clazz.simpleName}.js") }
+  override val dataUrl: URI by lazy {
+    parent!!.dataUrl.resolve("${clazz.simpleName.uriEncodedComponent}.js")
+  }
 
   override fun getMethod(name: String): MethodScope? =
     clazz.allMethods[name]?.let { MethodScope(it, this) }

pkl-doc/src/main/kotlin/org/pkl/doc/MainOrPackagePageGenerator.kt

@@ -70,9 +70,13 @@ internal abstract class MainOrPackagePageGenerator<S>(
                 } else {
                   link
                 }
+              if (moduleOrPackageScope is ModuleScope) {
+                +name.asModuleName
+              } else {
                 +name
               }
             }
+          }
 
           memberDocs.renderDocComment(this)
         }

pkl-doc/src/main/kotlin/org/pkl/doc/ModuleOrClassPageGenerator.kt

@@ -99,7 +99,7 @@ internal abstract class ModuleOrClassPageGenerator<S>(
                   span {
                     classes = setOf("name-decl")
 
-                    +propertyName
+                    +propertyName.asIdentifier
                   }
 
                   +": "
@@ -210,7 +210,7 @@ internal abstract class ModuleOrClassPageGenerator<S>(
                   span {
                     classes = setOf("name-decl")
 
-                    +method.simpleName
+                    +method.simpleName.asIdentifier
                   }
 
                   renderTypeParameters(method.typeParameters)

pkl-doc/src/main/kotlin/org/pkl/doc/ModulePageGenerator.kt

@@ -47,7 +47,7 @@ internal class ModulePageGenerator(
         h1 {
           id = "declaration-title"
 
-          +docModule.name
+          +docModule.name.asModuleName
 
           span {
             id = "declaration-version"
@@ -87,7 +87,7 @@ internal class ModulePageGenerator(
             span {
               classes = setOf("name-decl")
 
-              +docModule.name
+              +docModule.name.asModuleName
             }
 
             renderModuleAmendsOrExtendsClause(module)
@@ -105,7 +105,7 @@ internal class ModulePageGenerator(
   }
 
   // example output:
-  // module PodSpec (io.k8s/api/core/v1:befa7c51) • Pkl Hub
+  // module PodSpec (pkg.pkl-lang.org/pkl-k8s/k8s:1.0.0) • Package Docs
   override fun HTMLTag.renderPageTitle() {
     val moduleScope = pageScope
     val packageScope = moduleScope.parent!!

pkl-doc/src/main/kotlin/org/pkl/doc/PackagePageGenerator.kt

@@ -86,7 +86,7 @@ internal class PackagePageGenerator(
   }
 
   // example output:
-  // package io.k8s (befa7c51) • Pkl Hub
+  // package pkg.pkl-lang.org/pkl-k8s/k8s (1.0.0) • Package Docs
   override fun HTMLTag.renderPageTitle() {
     +pageScope.name
     +" ("

pkl-doc/src/main/kotlin/org/pkl/doc/PageGenerator.kt

@@ -268,12 +268,12 @@ internal abstract class PageGenerator<out S>(
       a {
         href = targetScope.urlRelativeTo(pageScope).toString()
         classes = setOf(cssClass)
-        +clazz.simpleDisplayName
+        +clazz.simpleDisplayName.asIdentifier
       }
     } else {
       span {
         classes = setOf(cssClass)
-        +clazz.simpleDisplayName
+        +clazz.simpleDisplayName.asIdentifier
       }
     }
   }
@@ -289,12 +289,12 @@ internal abstract class PageGenerator<out S>(
       a {
         href = targetScope.urlRelativeTo(pageScope).toString()
         classes = setOf(cssClass)
-        +typeAlias.simpleName
+        +typeAlias.simpleName.asIdentifier
       }
     } else {
       span {
         classes = setOf(cssClass)
-        +typeAlias.simpleName
+        +typeAlias.simpleName.asIdentifier
       }
     }
   }
@@ -426,7 +426,7 @@ internal abstract class PageGenerator<out S>(
   // anchors, and requires no JS
   protected fun HtmlBlockTag.renderAnchor(anchorId: String, cssClass: String = "anchor") {
     div {
-      id = anchorId
+      id = anchorId.uriEncodedComponent
       classes = setOf(cssClass)
       +" " // needs some content to be considered a valid anchor by browsers
     }
@@ -457,7 +457,7 @@ internal abstract class PageGenerator<out S>(
   protected fun HtmlBlockTag.renderSelfLink(memberName: String) {
     a {
       classes = setOf("member-selflink", "material-icons")
-      href = "#$memberName"
+      href = "#${memberName.uriEncodedComponent}"
       +"link"
     }
   }
@@ -600,7 +600,8 @@ internal abstract class PageGenerator<out S>(
         for (example in examples) {
           if (first) first = false else +", "
           a {
-            href = docModule.parent.docPackageInfo.getModuleSourceCode(example.moduleName)!!
+            href =
+              docModule.parent.docPackageInfo.getModuleSourceCode(example.moduleName)!!.toString()
             +example.shortModuleName
           }
         }

pkl-doc/src/main/kotlin/org/pkl/doc/Util.kt

@@ -16,11 +16,15 @@
 package org.pkl.doc
 
 import java.io.InputStream
+import java.net.URI
+import java.net.URLEncoder
+import java.nio.charset.StandardCharsets
 import java.nio.file.Path
 import kotlin.io.path.bufferedWriter
 import kotlin.io.path.outputStream
 import org.pkl.commons.createParentDirectories
 import org.pkl.core.*
+import org.pkl.core.parser.Lexer
 import org.pkl.core.util.json.JsonWriter
 
 // overwrites any existing file
@@ -114,3 +118,42 @@ internal fun String.replaceSourceCodePlaceholders(
     .replace("%{line}", sourceLocation.startLine.toString())
     .replace("%{endLine}", sourceLocation.endLine.toString())
 }
+
+/**
+ * Encodes a URI string, encoding characters that are part of URI syntax.
+ *
+ * Follows `encodeURIComponent` from ECMAScript.
+ */
+internal val String.uriEncodedComponent
+  get(): String {
+    val ret = URLEncoder.encode(this, StandardCharsets.UTF_8)
+    // Replace `+` with `%20` to be safe
+    // (see
+    // https://stackoverflow.com/questions/2678551/when-should-space-be-encoded-to-plus-or-20#:~:text=%20%20is%20a%20valid%20way,encodeURIComponent()%20does%20in%20JavaScript.)
+    return ret.replace("+", "%20")
+  }
+
+/**
+ * Encodes a URI string, preserving characters that are part of URI syntax.
+ *
+ * Follows `encodeURI` from ECMAScript.
+ */
+internal val String.uriEncoded
+  get(): String = replace(Regex("([^;/?:@&=+\$,#]+)")) { it.value.uriEncodedComponent }
+
+fun getModulePath(moduleName: String, packagePrefix: String): String =
+  moduleName.substring(packagePrefix.length).replace('.', '/')
+
+internal fun String.toEncodedUri(): URI = URI(uriEncoded)
+
+/**
+ * Turns `"foo.bar.baz-biz"` into ``"foo.bar.`baz-biz`"``.
+ *
+ * There's a chance that this is wrong; a module might look like: ``"module foo.`bar.baz`.biz"``.
+ * However, we don't keep around enough information to render this faithfully.
+ */
+internal val String.asModuleName: String
+  get() = split(".").map(Lexer::maybeQuoteIdentifier).joinToString(".") { it }
+
+internal val String.asIdentifier: String
+  get() = Lexer.maybeQuoteIdentifier(this)

pkl-doc/src/main/resources/org/pkl/doc/scripts/search-worker.js

@@ -14,6 +14,7 @@ if (isWorker) {
   const searchIndexUrl = workerName === "main" ?
       '../search-index.js' :
       '../' + workerName + '/search-index.js';
+  importScripts(searchIndexUrl);
   initSearchIndex();
   addEventListener('message', e => {
     const {query, packageName, moduleName, className} = e.data;
@@ -177,12 +178,11 @@ function toWordStarts(characters) {
   return result;
 }
 
-const regexIsUppercase = /\p{Lu}/u
-
-const regexIsNumericCharacter = /\p{N}/u
 
 // Partitions characters into uppercase, digit, dot, and other.
 function toCharClass(ch) {
+  const regexIsUppercase = /\p{Lu}/u
+  const regexIsNumericCharacter = /\p{N}/u
   return regexIsUppercase.test(ch) ? 3 : regexIsNumericCharacter.test(ch) ? 2 : ch === '.' ? 1 : 0;
 }
 

pkl-doc/src/test/files/DocGeneratorTest/input/com.externalpackage/doc-package-info.pkl

@@ -2,7 +2,7 @@ amends "pkl:DocPackageInfo"
 
 name = "com.externalpackage"
 version = "1.2.3"
-importUri = "https://pkl.io/"
+importUri = "https://example.com/"
 authors {
   "publisher-externalpackage@group.apple.com"
 }

pkl-doc/src/test/files/DocGeneratorTest/input/com.package1/Module Containing Spaces.pkl

@@ -0,0 +1,2 @@
+/// This is a module that has spaces in its name.
+module com.package1.`Module Containing Spaces`

pkl-doc/src/test/files/DocGeneratorTest/input/com.package1/doc-package-info.pkl

@@ -17,7 +17,7 @@ import "../com.externalpackage/external1.pkl"
 
 name = "com.package1"
 version = "1.2.3"
-importUri = "https://pkl.io/"
+importUri = "https://example.com/"
 authors {
   "package1-publisher@group.apple.com"
 }

pkl-doc/src/test/files/DocGeneratorTest/input/com.package1/referenceToExternalPackage.pkl

@@ -0,0 +1,4 @@
+import "../com.package2/Module3.pkl"
+
+/// Something something [Module3.`property {} four`].
+prop: Module3.`Class Two {}`

pkl-doc/src/test/files/DocGeneratorTest/input/com.package2/Module3.pkl

@@ -1,7 +1,10 @@
 module com.package2.Module3
 
+/// Something something [`property {} <> four`]
 property3: String
 
+`property {} <> four`: String
+
 function function3(n: Int): String = n.toString()
 
 class Class3 {
@@ -9,3 +12,7 @@ class Class3 {
 
   function function3(n: Int): String = n.toString()
 }
+
+class `Class Two {}` {
+  prop: String
+}

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/Module Containing Spaces/index.html

@@ -0,0 +1,196 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Module Containing Spaces (com.package1:1.2.3) • Docsite Title</title>
+    <script src="../../../scripts/pkldoc.js" defer="defer"></script>
+    <script src="../../../scripts/scroll-into-view.min.js" defer="defer"></script>
+    <script src="../../../data/com.package1/1.2.3/Module%20Containing%20Spaces/index.js" defer="defer"></script>
+    <link href="../../../styles/pkldoc.css" media="screen" type="text/css" rel="stylesheet">
+    <link rel="icon" type="image/svg+xml" href="../../../images/favicon.svg">
+    <link rel="apple-touch-icon" sizes="180x180" href="../../../images/apple-touch-icon.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="../../../images/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="../../../images/favicon-16x16.png">
+    <meta charset="UTF-8">
+  </head>
+  <body onload="onLoad()">
+    <header>
+      <div id="doc-title"><a href="../../../index.html">Docsite Title</a></div>
+      <div id="search"><i id="search-icon" class="material-icons">search</i><input id="search-input" type="search" placeholder="Click or press 'S' to search this package" autocomplete="off" data-package-name="com.package1" data-package-version="1.2.3" data-package-url-prefix="../" data-module-name="com.package1.Module Containing Spaces" data-root-url-prefix="../../../"></div>
+    </header>
+    <main><a class="declaration-parent-link" href="../../../index.html">Docsite Title</a> &gt; <a class="declaration-parent-link" href="../index.html">com.package1</a>
+      <h1 id="declaration-title">com.package1.`Module Containing Spaces`<span id="declaration-version">1.2.3</span></h1>
+      <ul class="member-group-links">
+        <li><a href="#_properties">Properties</a></li>
+        <li><a href="#_methods">Methods</a></li>
+      </ul>
+      <div id="_overview" class="anchor"> </div>
+      <div id="_declaration" class="member">
+        <div class="member-signature">module <span class="name-decl">com.package1.`Module Containing Spaces`</span></div>
+        <div class="doc-comment"><p>This is a module that has spaces in its name.</p></div>
+        <dl class="member-info">
+          <dt class="">Module URI:</dt>
+          <dd><span class="import-uri">https://example.com/Module%20Containing%20Spaces.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dt class="">Source code:</dt>
+          <dd><a href="https://example.com/package1/Module%20Containing%20Spaces.pkl">Module Containing Spaces.pkl</a></dd>
+          <dt class="runtime-data hidden">Known subtypes:</dt>
+          <dd id="known-subtypes" class="runtime-data hidden"></dd>
+          <dt class="runtime-data hidden">Known usages:</dt>
+          <dd id="known-usages" class="runtime-data hidden"></dd>
+          <dt class="runtime-data hidden">All versions:</dt>
+          <dd id="known-versions" class="runtime-data hidden"></dd>
+        </dl>
+      </div>
+      <div class="member-group">
+        <div id="_properties" class="anchor"> </div>
+        <h2 class="member-group-title">Properties<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
+        <ul>
+          <li>
+            <div id="output" class="anchor"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#output">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">hidden </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">output</span>: <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/ModuleOutput.html" class="name-ref">ModuleOutput</a><span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>The output of this module.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>Defaults to all module properties rendered as either Pcf or the format specified on the command line.</p></div>
+              </div>
+            </div>
+          </li>
+        </ul>
+      </div>
+      <div class="member-group">
+        <div id="_methods" class="anchor"> </div>
+        <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
+        <ul>
+          <li>
+            <div id="getClass%28%29" class="anchor"> </div>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">getClass</span>(): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Class.html" class="name-ref">Class</a><span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns the class of <code>this</code>.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="toString%28%29" class="anchor"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">toString</span>(): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a><span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns a string representation of <code>this</code>.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>This method is used to convert the values of string interpolation expressions to strings.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">ifNonNull</span>&lt;<a class="param1">Result</a>&gt;(<span class="param2">transform</span>: (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html#NonNull" class="name-ref">NonNull</a>) -&gt; <a href="index.html#ifNonNull().Result" class="name-ref">Result</a>): <a href="index.html#ifNonNull().Result" class="name-ref">Result</a>?<span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns <code>this |&gt; transform</code> if <code>this</code> is non-null, and <code>null</code> otherwise.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>This method is the complement of the <code>??</code> operator and the equivalent of an <code>Option</code> type's <code>map</code> and <code>flatMap</code> methods.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="hasProperty%28%29" class="anchor"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">hasProperty</span>(<span class="param1">name</span>: <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a>): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Boolean.html" class="name-ref">Boolean</a><span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Tells if this object has a property with the given <code>name</code>.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="getProperty%28%29" class="anchor"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">getProperty</span>(<span class="param1">name</span>: <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a>): unknown<span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns the value of the property with the given <code>name</code>.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>Throws if a property with this name does not exist.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">getPropertyOrNull</span>(<span class="param1">name</span>: <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a>): unknown?<span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns the value of the property with the given <code>name</code>.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>Returns <code>null</code> if a property with this name does not exist.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="toDynamic%28%29" class="anchor"> </div>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">toDynamic</span>(): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Dynamic.html" class="name-ref">Dynamic</a><span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Converts this object to a <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Dynamic.html"><code>Dynamic</code></a> object.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="toMap%28%29" class="anchor"> </div>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">toMap</span>(): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Map.html" class="name-ref">Map</a>&lt;<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a>, unknown&gt;<span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Converts this object to a <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Map.html"><code>Map</code></a>.</p></div>
+              </div>
+            </div>
+          </li>
+          <li>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
+              <div class="member-left">
+                <div class="member-modifiers">function </div>
+              </div>
+              <div class="member-main">
+                <div class="member-signature"><span class="name-decl">relativePathTo</span>(<span class="param1">other</span>: <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/Module.html" class="name-ref">Module</a>): <a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/List.html" class="name-ref">List</a>&lt;<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/String.html" class="name-ref">String</a>&gt;<span class="context"> (<a href="https://pages.github.com/apple/pkl/stdlib/pkl/0.24.0/base/index.html" class="name-ref">pkl.base</a>)</span><a class="member-source-link" href="https://github.com/apple/pkl/blob/0.24.0/stdlib/base.pkl#L123-L456">Source</a></div>
+                <div class="doc-comment"><p>Returns the relative, descendent directory path between this module and <code>other</code>.</p></div>
+                <div class="doc-comment expandable hidden collapsed"><p>Throws if no such path exists.</p>
+<p>For example, if module <code>mod1</code> has path <code>/dir1/mod1.pkl</code>, and module <code>mod2</code> has path <code>/dir1/dir2/dir3/mod2.pkl</code>,
+then <code>mod1.relativePathTo(mod2)</code> will return <code>List(&quot;dir2&quot;, &quot;dir3&quot;)</code>.</p>
+<p>A common use case is to compute the directory path between a template located at the root of a hierarchy
+(say <code>rootModule.pkl</code>) and the currently evaluated module (accessible via the <code>module</code> keyword):</p>
+<pre><code>import &quot;rootModule.pkl&quot; // self-import
+path = rootModule.relativePathTo(module)
+</code></pre></div>
+              </div>
+            </div>
+          </li>
+        </ul>
+      </div>
+    </main>
+  </body>
+</html>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/baseModule/BaseClass.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/baseModule/index.html

@@ -29,7 +29,7 @@
         <div class="member-signature">open module <span class="name-decl">com.package1.baseModule</span></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/baseModule.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/baseModule.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/baseModule.pkl">baseModule.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -75,8 +75,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -87,8 +87,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -100,10 +100,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -115,9 +115,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -128,9 +128,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -142,9 +142,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -156,8 +156,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -168,8 +168,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -180,9 +180,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -201,8 +201,8 @@ path = rootModule.relativePathTo(module)
             </div>
           </li>
           <li>
-            <div id="baseMethod()" class="anchor"> </div>
+            <div id="baseMethod%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#baseMethod()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#baseMethod%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classAnnotations/AnnotatedClass.html

@@ -42,8 +42,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -54,8 +54,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -67,10 +67,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -82,9 +82,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -95,9 +95,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -109,9 +109,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -123,8 +123,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -135,8 +135,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classAnnotations/AnnotatedClss.html

@@ -44,8 +44,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -56,8 +56,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -69,10 +69,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -84,9 +84,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -97,9 +97,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -111,9 +111,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -125,8 +125,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -137,8 +137,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classAnnotations/AnnotatedClssWithExpandableComment.html

@@ -44,8 +44,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -56,8 +56,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -69,10 +69,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -84,9 +84,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -97,9 +97,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -111,9 +111,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -125,8 +125,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -137,8 +137,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classAnnotations/index.html

@@ -29,7 +29,7 @@
         <div class="member-signature">open module <span class="name-decl">com.package1.classAnnotations</span></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classAnnotations.pkl">classAnnotations.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -64,8 +64,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -76,8 +76,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -89,10 +89,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -104,9 +104,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -117,9 +117,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -131,9 +131,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -145,8 +145,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -157,8 +157,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -169,9 +169,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments1.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments2.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments3.html

@@ -40,8 +40,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -52,8 +52,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -65,10 +65,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -80,9 +80,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -93,9 +93,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -107,9 +107,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -121,8 +121,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -133,8 +133,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments4.html

@@ -44,8 +44,8 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -56,8 +56,8 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -69,10 +69,10 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -84,9 +84,9 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -97,9 +97,9 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -111,9 +111,9 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -125,8 +125,8 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -137,8 +137,8 @@ Class with multi-line and multi-paragraph doc comment (paragraph2, line2).</p></
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments5.html

@@ -40,8 +40,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -52,8 +52,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -65,10 +65,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -80,9 +80,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -93,9 +93,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -107,9 +107,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -121,8 +121,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -133,8 +133,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments6.html

@@ -42,8 +42,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -54,8 +54,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -67,10 +67,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -82,9 +82,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -95,9 +95,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -109,9 +109,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -123,8 +123,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -135,8 +135,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments7.html

@@ -40,8 +40,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -52,8 +52,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -65,10 +65,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -80,9 +80,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -93,9 +93,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -107,9 +107,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -121,8 +121,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -133,8 +133,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/Comments8.html

@@ -91,8 +91,8 @@ class Person {
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -103,8 +103,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -116,10 +116,10 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -131,9 +131,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -144,9 +144,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,9 +158,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -172,8 +172,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -184,8 +184,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classComments/index.html

@@ -31,7 +31,7 @@
         <div class="doc-comment"><p>The greatest breakthrough since ever.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classComments.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classComments.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classComments.pkl">classComments.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -134,8 +134,8 @@ class Person {
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -146,8 +146,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -159,10 +159,10 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -174,9 +174,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -187,9 +187,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -201,9 +201,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -215,8 +215,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -227,8 +227,8 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -239,9 +239,9 @@ class Person {
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classInheritance/MyClass1.html

@@ -58,8 +58,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -70,8 +70,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -83,10 +83,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -98,9 +98,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -111,9 +111,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -125,9 +125,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -139,8 +139,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -151,8 +151,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -163,9 +163,9 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">abstract function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classInheritance/MyClass2.html

@@ -69,8 +69,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -81,8 +81,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -94,10 +94,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -109,9 +109,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -122,9 +122,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -136,9 +136,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -150,8 +150,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -162,8 +162,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -174,9 +174,9 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -187,9 +187,9 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div id="method2().arg" class="anchor-param1"> </div>
+            <div id="method2%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classInheritance/MyClass3.html

@@ -69,8 +69,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -81,8 +81,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -94,10 +94,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -109,9 +109,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -122,9 +122,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -136,9 +136,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -150,8 +150,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -162,8 +162,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -174,9 +174,9 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -187,9 +187,9 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div id="method2().arg" class="anchor-param1"> </div>
+            <div id="method2%28%29.arg" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classInheritance/MyClass4.html

@@ -80,8 +80,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,8 +92,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -105,10 +105,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,9 +120,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -133,9 +133,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -147,9 +147,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -161,8 +161,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -173,8 +173,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -185,9 +185,9 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -198,9 +198,9 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div id="method2().arg" class="anchor-param1"> </div>
+            <div id="method2%28%29.arg" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -210,9 +210,9 @@
             </div>
           </li>
           <li>
-            <div id="method3()" class="anchor"> </div>
+            <div id="method3%28%29" class="anchor"> </div>
-            <div id="method3().arg" class="anchor-param1"> </div>
+            <div id="method3%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method3()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method3%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classInheritance/index.html

@@ -30,7 +30,7 @@
         <div class="doc-comment"><p>Class inheritance involving abstract, open, and final classes.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classInheritance.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classInheritance.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classInheritance.pkl">classInheritance.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -65,8 +65,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -77,8 +77,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -90,10 +90,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -105,9 +105,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -118,9 +118,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,9 +132,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -146,8 +146,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,8 +158,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -170,9 +170,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodComments/Comments.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -144,8 +144,8 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -155,8 +155,8 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -166,8 +166,8 @@
             </div>
           </li>
           <li>
-            <div id="method3()" class="anchor"> </div>
+            <div id="method3%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method3()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method3%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -178,8 +178,8 @@
             </div>
           </li>
           <li>
-            <div id="method4()" class="anchor"> </div>
+            <div id="method4%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method4()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method4%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -192,8 +192,8 @@ doc comment.</p></div>
             </div>
           </li>
           <li>
-            <div id="method5()" class="anchor"> </div>
+            <div id="method5%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method5()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method5%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -204,8 +204,8 @@ doc comment.</p></div>
             </div>
           </li>
           <li>
-            <div id="method6()" class="anchor"> </div>
+            <div id="method6%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method6()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method6%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -218,8 +218,8 @@ doc comment.</p></div>
             </div>
           </li>
           <li>
-            <div id="method7()" class="anchor"> </div>
+            <div id="method7%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method7()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method7%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodComments/index.html

@@ -30,7 +30,7 @@
         <div class="doc-comment"><p>Class methods with different kinds of comments.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classMethodComments.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classMethodComments.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classMethodComments.pkl">classMethodComments.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -65,8 +65,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -77,8 +77,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -90,10 +90,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -105,9 +105,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -118,9 +118,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,9 +132,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -146,8 +146,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,8 +158,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -170,9 +170,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodModifiers/Modifiers.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -144,9 +144,9 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">abstract function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodModifiers/index.html

@@ -30,7 +30,7 @@
         <div class="doc-comment"><p>Class methods with different modifiers.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classMethodModifiers.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classMethodModifiers.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classMethodModifiers.pkl">classMethodModifiers.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -65,8 +65,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -77,8 +77,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -90,10 +90,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -105,9 +105,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -118,9 +118,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,9 +132,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -146,8 +146,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,8 +158,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -170,9 +170,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodTypeAnnotations/TypeAnnotations.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -144,8 +144,8 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -156,9 +156,9 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div id="method2().arg1" class="anchor-param1"> </div>
+            <div id="method2%28%29.arg1" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -169,10 +169,10 @@
             </div>
           </li>
           <li>
-            <div id="method3()" class="anchor"> </div>
+            <div id="method3%28%29" class="anchor"> </div>
-            <div id="method3().arg1" class="anchor-param1"> </div>
+            <div id="method3%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method3().arg2" class="anchor-param2"> </div>
+            <div id="method3%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method3()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method3%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -183,8 +183,8 @@
             </div>
           </li>
           <li>
-            <div id="method4()" class="anchor"> </div>
+            <div id="method4%28%29" class="anchor"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method4()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method4%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -195,9 +195,9 @@
             </div>
           </li>
           <li>
-            <div id="method5()" class="anchor"> </div>
+            <div id="method5%28%29" class="anchor"> </div>
-            <div id="method5().arg1" class="anchor-param1"> </div>
+            <div id="method5%28%29.arg1" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method5()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method5%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -208,10 +208,10 @@
             </div>
           </li>
           <li>
-            <div id="method6()" class="anchor"> </div>
+            <div id="method6%28%29" class="anchor"> </div>
-            <div id="method6().arg1" class="anchor-param1"> </div>
+            <div id="method6%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method6().arg2" class="anchor-param2"> </div>
+            <div id="method6%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method6()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method6%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -222,10 +222,10 @@
             </div>
           </li>
           <li>
-            <div id="method7()" class="anchor"> </div>
+            <div id="method7%28%29" class="anchor"> </div>
-            <div id="method7().arg1" class="anchor-param1"> </div>
+            <div id="method7%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method7().arg2" class="anchor-param2"> </div>
+            <div id="method7%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method7()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method7%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -236,10 +236,10 @@
             </div>
           </li>
           <li>
-            <div id="method8()" class="anchor"> </div>
+            <div id="method8%28%29" class="anchor"> </div>
-            <div id="method8().arg1" class="anchor-param1"> </div>
+            <div id="method8%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method8().arg2" class="anchor-param2"> </div>
+            <div id="method8%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method8()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method8%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -250,10 +250,10 @@
             </div>
           </li>
           <li>
-            <div id="method9()" class="anchor"> </div>
+            <div id="method9%28%29" class="anchor"> </div>
-            <div id="method9().arg1" class="anchor-param1"> </div>
+            <div id="method9%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method9().arg2" class="anchor-param2"> </div>
+            <div id="method9%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method9()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method9%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -264,10 +264,10 @@
             </div>
           </li>
           <li>
-            <div id="method10()" class="anchor"> </div>
+            <div id="method10%28%29" class="anchor"> </div>
-            <div id="method10().arg1" class="anchor-param1"> </div>
+            <div id="method10%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method10().arg2" class="anchor-param2"> </div>
+            <div id="method10%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method10()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method10%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -278,10 +278,10 @@
             </div>
           </li>
           <li>
-            <div id="method11()" class="anchor"> </div>
+            <div id="method11%28%29" class="anchor"> </div>
-            <div id="method11().arg1" class="anchor-param1"> </div>
+            <div id="method11%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method11().arg2" class="anchor-param2"> </div>
+            <div id="method11%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method11()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method11%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -292,10 +292,10 @@
             </div>
           </li>
           <li>
-            <div id="method12()" class="anchor"> </div>
+            <div id="method12%28%29" class="anchor"> </div>
-            <div id="method12().arg1" class="anchor-param1"> </div>
+            <div id="method12%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method12().arg2" class="anchor-param2"> </div>
+            <div id="method12%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method12()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method12%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -306,9 +306,9 @@
             </div>
           </li>
           <li>
-            <div id="method13()" class="anchor"> </div>
+            <div id="method13%28%29" class="anchor"> </div>
-            <div id="method13().arg1" class="anchor-param1"> </div>
+            <div id="method13%28%29.arg1" class="anchor-param1"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method13()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method13%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodTypeAnnotations/index.html

@@ -30,7 +30,7 @@
         <div class="doc-comment"><p>Class methods with different kinds of type annotations.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classMethodTypeAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classMethodTypeAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classMethodTypeAnnotations.pkl">classMethodTypeAnnotations.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -65,8 +65,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -77,8 +77,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -90,10 +90,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -105,9 +105,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -118,9 +118,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,9 +132,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -146,8 +146,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,8 +158,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -170,9 +170,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodTypeReferences/MyClass.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodTypeReferences/TypeReferences.html

@@ -39,8 +39,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -51,8 +51,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -64,10 +64,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -79,9 +79,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -92,9 +92,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -120,8 +120,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -132,8 +132,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -144,10 +144,10 @@
             </div>
           </li>
           <li>
-            <div id="method1()" class="anchor"> </div>
+            <div id="method1%28%29" class="anchor"> </div>
-            <div id="method1().arg1" class="anchor-param1"> </div>
+            <div id="method1%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method1().arg2" class="anchor-param2"> </div>
+            <div id="method1%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method1()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method1%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -158,10 +158,10 @@
             </div>
           </li>
           <li>
-            <div id="method2()" class="anchor"> </div>
+            <div id="method2%28%29" class="anchor"> </div>
-            <div id="method2().arg1" class="anchor-param1"> </div>
+            <div id="method2%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method2().arg2" class="anchor-param2"> </div>
+            <div id="method2%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method2()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method2%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -172,10 +172,10 @@
             </div>
           </li>
           <li>
-            <div id="method3()" class="anchor"> </div>
+            <div id="method3%28%29" class="anchor"> </div>
-            <div id="method3().arg1" class="anchor-param1"> </div>
+            <div id="method3%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method3().arg2" class="anchor-param2"> </div>
+            <div id="method3%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method3()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method3%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -186,10 +186,10 @@
             </div>
           </li>
           <li>
-            <div id="method4()" class="anchor"> </div>
+            <div id="method4%28%29" class="anchor"> </div>
-            <div id="method4().arg1" class="anchor-param1"> </div>
+            <div id="method4%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method4().arg2" class="anchor-param2"> </div>
+            <div id="method4%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method4()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method4%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -200,10 +200,10 @@
             </div>
           </li>
           <li>
-            <div id="method5()" class="anchor"> </div>
+            <div id="method5%28%29" class="anchor"> </div>
-            <div id="method5().arg1" class="anchor-param1"> </div>
+            <div id="method5%28%29.arg1" class="anchor-param1"> </div>
-            <div id="method5().arg2" class="anchor-param2"> </div>
+            <div id="method5%28%29.arg2" class="anchor-param2"> </div>
-            <div class="member"><a class="member-selflink material-icons" href="#method5()">link</a>
+            <div class="member"><a class="member-selflink material-icons" href="#method5%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classMethodTypeReferences/index.html

@@ -31,7 +31,7 @@
 the same module, a different module, and external modules.</p></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classMethodTypeReferences.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classMethodTypeReferences.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classMethodTypeReferences.pkl">classMethodTypeReferences.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -66,8 +66,8 @@ the same module, a different module, and external modules.</p></div>
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -78,8 +78,8 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -91,10 +91,10 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -106,9 +106,9 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -119,9 +119,9 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -133,9 +133,9 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -147,8 +147,8 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -159,8 +159,8 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -171,9 +171,9 @@ the same module, a different module, and external modules.</p></div>
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classPropertyAnnotations/ClassWithAnnotatedProperty.html

@@ -57,8 +57,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -69,8 +69,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -82,10 +82,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -97,9 +97,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -110,9 +110,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -124,9 +124,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -138,8 +138,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -150,8 +150,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classPropertyAnnotations/UserDefinedAnnotation.html

@@ -68,8 +68,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -80,8 +80,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -93,10 +93,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -108,9 +108,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -121,9 +121,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -135,9 +135,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -149,8 +149,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -161,8 +161,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>

pkl-doc/src/test/files/DocGeneratorTest/output/com.package1/1.2.3/classPropertyAnnotations/index.html

@@ -29,7 +29,7 @@
         <div class="member-signature">module <span class="name-decl">com.package1.classPropertyAnnotations</span></div>
         <dl class="member-info">
           <dt class="">Module URI:</dt>
-          <dd><span class="import-uri">https://pkl.io/classPropertyAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
+          <dd><span class="import-uri">https://example.com/classPropertyAnnotations.pkl</span><i class="copy-uri-button material-icons">content_copy</i></dd>
           <dt class="">Source code:</dt>
           <dd><a href="https://example.com/package1/classPropertyAnnotations.pkl">classPropertyAnnotations.pkl</a></dd>
           <dt class="runtime-data hidden">Known subtypes:</dt>
@@ -64,8 +64,8 @@
         <h2 class="member-group-title">Methods<span class="toggle-inherited-members">(<span class="toggle-inherited-members-link button-link">show inherited</span>)</span></h2>
         <ul>
           <li>
-            <div id="getClass()" class="anchor"> </div>
+            <div id="getClass%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#getClass%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -76,8 +76,8 @@
             </div>
           </li>
           <li>
-            <div id="toString()" class="anchor"> </div>
+            <div id="toString%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#toString%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -89,10 +89,10 @@
             </div>
           </li>
           <li>
-            <div id="ifNonNull()" class="anchor"> </div>
+            <div id="ifNonNull%28%29" class="anchor"> </div>
-            <div id="ifNonNull().Result" class="anchor-param1"> </div>
+            <div id="ifNonNull%28%29.Result" class="anchor-param1"> </div>
-            <div id="ifNonNull().transform" class="anchor-param2"> </div>
+            <div id="ifNonNull%28%29.transform" class="anchor-param2"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#ifNonNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -104,9 +104,9 @@
             </div>
           </li>
           <li>
-            <div id="hasProperty()" class="anchor"> </div>
+            <div id="hasProperty%28%29" class="anchor"> </div>
-            <div id="hasProperty().name" class="anchor-param1"> </div>
+            <div id="hasProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#hasProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -117,9 +117,9 @@
             </div>
           </li>
           <li>
-            <div id="getProperty()" class="anchor"> </div>
+            <div id="getProperty%28%29" class="anchor"> </div>
-            <div id="getProperty().name" class="anchor-param1"> </div>
+            <div id="getProperty%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getProperty%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -131,9 +131,9 @@
             </div>
           </li>
           <li>
-            <div id="getPropertyOrNull()" class="anchor"> </div>
+            <div id="getPropertyOrNull%28%29" class="anchor"> </div>
-            <div id="getPropertyOrNull().name" class="anchor-param1"> </div>
+            <div id="getPropertyOrNull%28%29.name" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#getPropertyOrNull%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -145,8 +145,8 @@
             </div>
           </li>
           <li>
-            <div id="toDynamic()" class="anchor"> </div>
+            <div id="toDynamic%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toDynamic%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -157,8 +157,8 @@
             </div>
           </li>
           <li>
-            <div id="toMap()" class="anchor"> </div>
+            <div id="toMap%28%29" class="anchor"> </div>
-            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap()">link</a>
+            <div class="member inherited expandable hidden collapsed"><a class="member-selflink material-icons" href="#toMap%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>
@@ -169,9 +169,9 @@
             </div>
           </li>
           <li>
-            <div id="relativePathTo()" class="anchor"> </div>
+            <div id="relativePathTo%28%29" class="anchor"> </div>
-            <div id="relativePathTo().other" class="anchor-param1"> </div>
+            <div id="relativePathTo%28%29.other" class="anchor-param1"> </div>
-            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo()">link</a>
+            <div class="member inherited expandable hidden collapsed with-expandable-docs"><i class="material-icons expandable-docs-icon">expand_more</i><a class="member-selflink material-icons" href="#relativePathTo%28%29">link</a>
               <div class="member-left">
                 <div class="member-modifiers">function </div>
               </div>