Add overrides for easier control of sub figure layout

README.md

@@ -29,13 +29,13 @@ Above in @full, we see a figure which is composed of 2 other figures, namely @a
 ## Known Issues
 - [x] Relative numbering is incorrect for super-figures, see [#1]
 - [ ] Supplement is always "Figure", regardless of `text.lang`, see: [#2]
-- [ ] Figure show rule cannot be easily reconfigured
+- [x] Figure show rule cannot be easily reconfigured
 
 ## TODO
 The following tasks remain before the first version of subpar is released:
 - [x] documentation
 - [ ] manual generation
-- [ ] allow more control over figure layout
+- [x] allow more control over figure layout
 - [ ] add convenient warppers for common types of super figures
 - [x] add input validation
 - [ ] add a more comprehensive test suite

src/lib.typ

@@ -30,6 +30,10 @@
 /// - outlined-sub (bool): Whether the sub figures should appear in an outline
 ///   of figures.
 /// - label: The label to attach to this super figure.
+/// - show-sub (function, auto): A show rule override for sub figures. Recevies
+///   the sub figure.
+/// - show-sub-caption (function, auto): A show rule override for sub figure's
+///   captions. Receives the realized numbering and caption element.
 /// -> content
 #let subpar(
   kind: image,
@@ -47,6 +51,9 @@
   outlined-sub: false,
   label: none,
 
+  show-sub: auto,
+  show-sub-caption: auto,
+
   body,
 ) = {
   _pkg.t4t.assert.any-type(str, function, kind)
@@ -63,6 +70,16 @@
   _pkg.t4t.assert.any-type(bool, outlined-sub)
   _pkg.t4t.assert.any-type(_label, label)
 
+  _pkg.t4t.assert.any-type(function, type(auto), show-sub)
+  _pkg.t4t.assert.any-type(function, type(auto), show-sub-caption)
+
+  show-sub = _pkg.t4t.def.if-auto(it => it, show-sub)
+  show-sub-caption = _pkg.t4t.def.if-auto((num, it) => {
+    num
+    [ ]
+    it.body
+  }, show-sub-caption)
+
   context {
     let n-super = counter(figure.where(kind: kind)).get().first() + 1
 
@@ -92,13 +109,10 @@
           placement: none,
         )
 
+        show figure: show-sub
         show figure: it => {
           let n-sub = sub-figure-counter.get().first() + 1
-          show figure.caption: it => {
-            _numbering(numbering-sub, n-sub)
-            [ ]
-            it.body
-          }
+          show figure.caption: show-sub-caption.with(_numbering(numbering-sub, n-sub))
 
           sub-figure-counter.step()
           it