This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-dev-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 24f944b9 2026/07/16 09:43:28: Generated dev website from
groovy-website@7b3bd4b
24f944b9 is described below
commit 24f944b96751c9918d42e18011dc7a5735fddeef
Author: jenkins <[email protected]>
AuthorDate: Thu Jul 16 09:43:28 2026 +0000
2026/07/16 09:43:28: Generated dev website from groovy-website@7b3bd4b
---
search/search-index.json | 2 +-
wiki/GEP-27.html | 64 ++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 65 insertions(+), 1 deletion(-)
diff --git a/search/search-index.json b/search/search-index.json
index 0b7b7c4f..01b5e198 100644
--- a/search/search-index.json
+++ b/search/search-index.json
@@ -891,7 +891,7 @@
{
"id": "wiki/GEP-27.html",
"title": "The Apache Groovy programming language - Developer docs -
GEP-27",
- "content": "The Apache Groovy programming language - Developer docs -
GEP-27 Socialize Discuss on the mailing list Groovy on X Groovy on Bluesky
Groovy on Mastodon Groovy on LinkedIn Events and conferences Source code on
GitHub Report issues in Jira Stack Overflow questions Slack Community You are
using an outdated browser. Please upgrade your browser to improve your
experience. Apache Groovy™ Learn Documentation Download Support
Contribute Ecosystem Blog posts Socialize GE [...]
+ "content": "The Apache Groovy programming language - Developer docs -
GEP-27 Socialize Discuss on the mailing list Groovy on X Groovy on Bluesky
Groovy on Mastodon Groovy on LinkedIn Events and conferences Source code on
GitHub Report issues in Jira Stack Overflow questions Slack Community You are
using an outdated browser. Please upgrade your browser to improve your
experience. Apache Groovy™ Learn Documentation Download Support
Contribute Ecosystem Blog posts Socialize GE [...]
"url": "wiki/GEP-27.html",
"site": "dev"
},
diff --git a/wiki/GEP-27.html b/wiki/GEP-27.html
index 3c95fa4b..bbc7f34d 100644
--- a/wiki/GEP-27.html
+++ b/wiki/GEP-27.html
@@ -760,6 +760,65 @@ owner-correct retargeting (Groovy 7) — but the trivial
subset need not wait fo
retargeting, see <em>Reference implementation</em>.)</p>
</div>
</div>
+<div class="sect2">
+<h3 id="_the_packability_decision_procedure">The packability decision
procedure</h3>
+<div class="paragraph">
+<p>The complete boundary, as implemented
(<code>ClosureWriter#chooseStrategy</code>; any decline keeps the
+closure a generated class exactly as today, and is what
<code>WARN</code>/<code>STRICT</code> — or
+<code>groovy.target.closure.pack.report=true</code> on the flag path — reports
with a reason):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><strong>Real-<code>Closure</code> semantics?</strong> References
<code>owner</code>/<code>delegate</code>/<code>thisObject</code>/<code>resolveStrategy</code>/
+<code>metaClass</code>/<code>super</code>, has default parameter values, or
contains an anonymous inner class → decline.</p>
+</li>
+<li>
+<p><strong>Scope opted out?</strong> The most-specific
<code>@PackedClosures</code> mode wins (method over class);
+<code>DISABLED</code> beats an enclosing opt-in and the flag → decline.</p>
+</li>
+<li>
+<p><strong>Triggered and sound?</strong> One of: the annotation (dynamic trust
+ runtime guard); the flag plus the
+syntactic no-free-name proof (dynamic — any implicit-this call or property,
field/property-bound
+or dynamic bare name, or explicit <code>this</code>-property declines); the
flag or annotation plus the type
+checker’s delegate-independence proof (<code>@CompileStatic</code> —
which also declines names a
+type-checking extension left to runtime resolution, and
<code>this</code>-properties of <code>Map</code>-implementing
+owners). Otherwise → decline.</p>
+</li>
+<li>
+<p><strong>Structural position:</strong> written directly in a method of the
owner class; nested closures await
+owner-correct retargeting (Groovy 7) → decline.</p>
+</li>
+<li>
+<p><strong>Visible escape:</strong> stored to a field/property/index,
returned, appended with <code><<</code>, or placed in a
+collection literal → decline.</p>
+</li>
+<li>
+<p><strong>Visibly serialization-bound:</strong> cast/coerced to a
<code>Serializable</code> type, or passed to <code>writeObject</code>
+directly or via a literal-holding local → decline.</p>
+</li>
+<li>
+<p><strong>Field initialiser:</strong> a class-level <code>def x = { …
}</code> (a field store outside any method’s visible
+code) → decline.</p>
+</li>
+<li>
+<p><strong>Intersection cast:</strong> the generated class would need
per-literal marker interfaces → decline.</p>
+</li>
+<li>
+<p><strong>Trait body:</strong> trait methods live in
<code>$Trait$Helper</code> with a synthetic receiver → decline.</p>
+</li>
+<li>
+<p><strong>Constructor special call:</strong> an argument to
<code>this(…​)</code>/<code>super(…​)</code>, where
<code>this</code> is not yet
+initialised → decline.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Everything that passes packs. The matrix is pinned as executable
documentation by
+<code>PackedClosureBoundariesTest</code> (18 shapes × both compilation modes,
plus the special-context
+shapes), and each gate has focused behavioural tests besides.</p>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -1053,6 +1112,11 @@ means byte-for-byte today’s behaviour.</p>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>groovy.target.closure.pack</code> (syntactic
proof)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">off
(opt-in)</p></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Decline
reporting on the flag path</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>groovy.target.closure.pack.report</code> — every
non-packed closure gets a compiler warning naming the gate that declined
it</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">off</p></td>
+</tr>
</tbody>
</table>
<div class="paragraph">
