kinescript 1.3.0__tar.gz → 1.3.1__tar.gz

{kinescript-1.3.0 → kinescript-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinescript
-Version: 1.3.0
+Version: 1.3.1
 Summary: Render motion graphics, video edits and voice-over from JSON scenes on the GPU, with checks an agent can read.
 Author: Dr. Know How
 License-Expression: MIT
@@ -135,13 +135,15 @@ Sounds are a top-level `audio` list, timed like layers and mixed by ffmpeg while
 - **Voice-over from text.** Write what a voice says in `text` and `kine voice` speaks it through a plugin, writing
   the file and its word times: [Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)
   (local, fast),
-  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local, tags,
+  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local,
   cloned voices) or [ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs)
   (cloud, needs an API key), picked per sound with `backend`. `[[go]]` in the text names the next
   word, so a cue to `vo1:go` survives a rewrite of the line. Only a line whose text, speaker, rate, backend or
   options changed is spoken again, and rendering never calls a speech engine.
-- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell Chatterbox and ElevenLabs how to say
-  what follows. Tags are not words, so cues, marks and captions skip them, and Kokoro says the line without them.
+- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell ElevenLabs how to say what follows.
+  Chatterbox takes them too but acts them only some of the time: in test takes it made a sound where `[laughs]`
+  goes in six of nine and whispered in none of seven. Tags are not words, so cues, marks and captions skip them,
+  and Kokoro says the line without them.
 - **A mix without listening.** Give a sound a `role` and it is set to that role's level: voice -18 LUFS, music
   -16, ambience -30, effects peaking at -6 dBFS. Music and ambience dip 14 dB while a voice speaks, an effect's
   leading silence is skipped so it lands on its cue, and the whole mix ends at -16 LUFS with peaks under
@@ -167,14 +169,20 @@ A narrated beat with a click on a marked word, over music that ducks under the v
 
 `kine voice scene.json` speaks it once. The
 [voice demo](https://drknowhow.github.io/kinescript/#sound) on the project site plays the result with sound, next
-to its scene file. The Kokoro plugin needs Python 3.10 to 3.12:
+to its scene file. Install the plugin for the voice you want next to Kinescript:
 
 ```bash
-pip install kinescript-kokoro
+pip install kinescript-kokoro       # local and fast; Python 3.10 to 3.12
+pip install kinescript-chatterbox   # local, copies a voice from a clip, tags hit or miss; installs PyTorch
+pip install kinescript-elevenlabs   # ElevenLabs' API, acts on tags; needs ELEVENLABS_API_KEY
 ```
 
-On a newer Python, install it into another one and point `KINE_VOICE_CMD` at it
-([details](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)).
+A plugin can also live in another Python, for Kokoro on Python 3.13 or newer or to keep PyTorch out of
+Kinescript's environment: point `KINE_VOICE_CMD`, or `KINE_VOICE_CMD_<NAME>` for one backend, at it. Each plugin's
+README has the details:
+[Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro),
+[Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox),
+[ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs).
 
 ## Built for agents
 

{kinescript-1.3.0 → kinescript-1.3.1}/README.md

@@ -88,13 +88,15 @@ Sounds are a top-level `audio` list, timed like layers and mixed by ffmpeg while
 - **Voice-over from text.** Write what a voice says in `text` and `kine voice` speaks it through a plugin, writing
   the file and its word times: [Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)
   (local, fast),
-  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local, tags,
+  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local,
   cloned voices) or [ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs)
   (cloud, needs an API key), picked per sound with `backend`. `[[go]]` in the text names the next
   word, so a cue to `vo1:go` survives a rewrite of the line. Only a line whose text, speaker, rate, backend or
   options changed is spoken again, and rendering never calls a speech engine.
-- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell Chatterbox and ElevenLabs how to say
-  what follows. Tags are not words, so cues, marks and captions skip them, and Kokoro says the line without them.
+- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell ElevenLabs how to say what follows.
+  Chatterbox takes them too but acts them only some of the time: in test takes it made a sound where `[laughs]`
+  goes in six of nine and whispered in none of seven. Tags are not words, so cues, marks and captions skip them,
+  and Kokoro says the line without them.
 - **A mix without listening.** Give a sound a `role` and it is set to that role's level: voice -18 LUFS, music
   -16, ambience -30, effects peaking at -6 dBFS. Music and ambience dip 14 dB while a voice speaks, an effect's
   leading silence is skipped so it lands on its cue, and the whole mix ends at -16 LUFS with peaks under
@@ -120,14 +122,20 @@ A narrated beat with a click on a marked word, over music that ducks under the v
 
 `kine voice scene.json` speaks it once. The
 [voice demo](https://drknowhow.github.io/kinescript/#sound) on the project site plays the result with sound, next
-to its scene file. The Kokoro plugin needs Python 3.10 to 3.12:
+to its scene file. Install the plugin for the voice you want next to Kinescript:
 
 ```bash
-pip install kinescript-kokoro
+pip install kinescript-kokoro       # local and fast; Python 3.10 to 3.12
+pip install kinescript-chatterbox   # local, copies a voice from a clip, tags hit or miss; installs PyTorch
+pip install kinescript-elevenlabs   # ElevenLabs' API, acts on tags; needs ELEVENLABS_API_KEY
 ```
 
-On a newer Python, install it into another one and point `KINE_VOICE_CMD` at it
-([details](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)).
+A plugin can also live in another Python, for Kokoro on Python 3.13 or newer or to keep PyTorch out of
+Kinescript's environment: point `KINE_VOICE_CMD`, or `KINE_VOICE_CMD_<NAME>` for one backend, at it. Each plugin's
+README has the details:
+[Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro),
+[Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox),
+[ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs).
 
 ## Built for agents
 

{kinescript-1.3.0 → kinescript-1.3.1}/kinescript/__init__.py

@@ -9,5 +9,5 @@ except ImportError as e:  # on Linux the wheel loads the system's EGL and GL, ev
 from .output import render, still
 from .scene import Scene, SceneError, load
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 __all__ = ["Scene", "SceneError", "load", "render", "still", "__version__"]

{kinescript-1.3.0 → kinescript-1.3.1}/kinescript/components.py

@@ -182,6 +182,17 @@ def _fill_template(v, params):
 _counter = [0]
 
 
+def _own(layers, pid: str) -> None:
+    """Put the instance id in front of the ids of a scene component's layers, nested ones too, so it can be used
+    more than once."""
+    for k in layers:
+        if not isinstance(k, dict):
+            continue
+        if "id" in k and not str(k["id"]).startswith(f"{pid}-"):
+            k["id"] = f"{pid}-{k['id']}"
+        _own(k.get("children") or [], pid)
+
+
 def expand(raw, user: dict, theme: dict, scene=None):
     if not isinstance(raw, dict):
         return raw
@@ -201,7 +212,7 @@ def expand(raw, user: dict, theme: dict, scene=None):
         _unused(name, raw, names, scene)
         for i, k in enumerate(body):
             k.setdefault("id", f"{params['id']}-{i}")
-            k["id"] = f"{params['id']}-{k['id']}" if not str(k["id"]).startswith(params["id"]) else k["id"]
+        _own(body, params["id"])
         out = {"type": "group", "x": raw.get("x", 0), "y": raw.get("y", 0), "children": body}
     elif name in BUILTIN:
         out = BUILTIN[name](params, theme)

{kinescript-1.3.0 → kinescript-1.3.1}/kinescript/docs.py

@@ -76,7 +76,8 @@ KEYS EVERY LAYER HAS
   x, y          position of the anchor. A number (px), "50%" (of the canvas, or of the group's
                 w and h), "50%-120", "10vw", "5vh", or an expression.
   anchor        center (default) | topleft | top | topright | left | right | bottomleft | bottom |
-                bottomright. Video, shader, and image without x default to topleft.
+                bottomright. Video and shader default to topleft, even with x and y set; an image
+                defaults to topleft without x and to center with it.
   opacity       0..1 (default 1)
   scale, scaleX, scaleY   1 = normal size
   rotate        degrees, clockwise
@@ -92,7 +93,8 @@ KEYS EVERY LAYER HAS
   enter, exit   a motion (see ENTER AND EXIT)
   hidden        true skips the layer (and its sound)
   sound         a file played when the layer starts, timed by the layer (see SOUND)
-  allowOffscreen  true stops check warning when the layer leaves the canvas
+  allowOffscreen  true stops check warning when the layer leaves the canvas; on a group or
+                  sequence it covers the layers inside
   note          free text, ignored
 
 LAYER TYPES (defaults in brackets)
@@ -280,7 +282,8 @@ COMPONENTS  {"use": "<name>", "id": "...", "at": ..., "dur": ..., ...parameters}
   scale, rotate, hidden, sound.
   Your own: "components": {"badge": {"params": {"label": "NEW"}, "layers": [
               {"type": "text", "text": "{{label}}", "size": 40}]}}
-  then a layer {"use": "badge", "label": "BETA", "x": 200, "y": 100}.
+  then a layer {"use": "badge", "label": "BETA", "x": 200, "y": 100}. Its layers' ids, nested ones too,
+  get the instance id in front ("b1-title" for "title" in {"use": "badge", "id": "b1"}).
 
 SOUND
   Top-level "audio" lists the sounds. Each one:
@@ -338,8 +341,10 @@ SOUND
   backend (kokoro, chatterbox, elevenlabs, each a plugin) and hands it settings with options:
     {"id": "vo2", "role": "voice", "text": "[whispers] Nobody knows. [laughs] Yet.", "backend": "elevenlabs",
      "speaker": "George", "options": {"stability": 0.3}}
-  chatterbox acts on [laugh], [chuckle], [sigh], [gasp], [cough], [clear throat], [whispering], [angry],
-  [happy], [sarcastic], [surprised], [crying] and a few more ([laughs] reads as [laugh]); its speaker
+  chatterbox takes [laugh], [chuckle], [sigh], [gasp], [cough], [clear throat], [whispering], [angry],
+  [happy], [sarcastic], [surprised], [crying] and a few more ([laughs] reads as [laugh]), but acts them
+  only some of the time ([laugh] made a sound in 6 of 9 test takes, [whispering] whispered in 0 of 7),
+  so use elevenlabs when a line needs its tags heard; its speaker
   is a clip of 5 s or more whose voice it copies, and "options": {"model": "standard", "exaggeration": 0.8}
   trades the tags for stronger emotion. elevenlabs needs an ELEVENLABS_API_KEY and uses the account's
   quota; its speaker is a voice name or id, its options model (eleven_v4), stability, style and
@@ -387,8 +392,10 @@ COMMANDS
   kine new scene.json             write a starter scene
   kine check scene.json           JSON list of problems. error: must fix. warning: should fix:
                                   text off the canvas or inside the outer 5% (safe-area),
-                                  overlapping text, contrast under 3:1, or text shown for less
-                                  than about 0.4 s + 0.3 s per word (read-time). With sound (it is
+                                  overlapping text, contrast under 3:1, text shown for less
+                                  than about 0.4 s + 0.3 s per word (read-time), or a video,
+                                  image or shader more than half off the canvas for 1 s or more
+                                  (media-offscreen). With sound (it is
                                   mixed and measured, see SOUND): a voice cut off (audio-cut), two
                                   voices at once (voice-overlap), music under 10 LU below a voice
                                   (voice-masked), an sfx whose first sound is late (sfx-late), a

{kinescript-1.3.0 → kinescript-1.3.1}/kinescript/verify.py

@@ -19,6 +19,10 @@ from .scene import Scene, SceneError, load
 # Model triangles one frame may draw before check warns. 100,000 took 71 ms a frame at 1080p on
 # the GPU in the 3D spike (2026-10-29), against about 15 ms at 20,000.
 TRIANGLE_BUDGET = 60_000
+# Layers check warns about when more than half of one stays off the canvas for MEDIA_OFF_FOR seconds; a slide or
+# a transition passes through faster.
+MEDIA = ("video", "image", "shader")
+MEDIA_OFF_FOR = 1.0
 
 
 def _times(scene: Scene, count: int, times=None) -> list[float]:
@@ -149,6 +153,7 @@ def check(src, step: float = 0.25, safe: float = 0.05) -> dict:
     pool.shutdown(wait=False)
     r = Renderer(scene, track=True, scale=1.0)
     found: dict[tuple, dict] = {}
+    off: dict[str, list] = {}  # media layer (or its sequence) id -> (time, box, share off, layer) when mostly off
 
     def add(level, code, lid, T, msg, fix="", until=None):
         key = (code, lid)
@@ -183,8 +188,10 @@ def check(src, step: float = 0.25, safe: float = 0.05) -> dict:
             if b["alpha"] < 0.3:
                 continue
             l, t, rr, bb = b["rect"]
-            layer = scene.by_id.get(lid)
-            allow = layer is not None and layer.raw.get("allowOffscreen")
+            layer = up = scene.by_id.get(lid)
+            allow = False
+            while up is not None and not allow:  # set on a group or sequence, it covers what is inside
+                allow, up = bool(up.raw.get("allowOffscreen")), up.parent
             if b["type"] in ("text", "counter", "captions"):
                 texts.append((lid, b))
                 if b.get("mirrored"):
@@ -200,7 +207,13 @@ def check(src, step: float = 0.25, safe: float = 0.05) -> dict:
                 if px < H / 45 and b["alpha"] > 0.9:
                     add("warning", "tiny-text", lid, T, f"text renders at ~{px:.0f}px, small for {H}p video",
                         f"use at least {math.ceil(H / 45)}px")
-            elif b["type"] not in ("video", "group") and not allow:
+            elif b["type"] in MEDIA:
+                area = (rr - l) * (bb - t)
+                seen = max(0.0, min(rr, W) - max(l, 0.0)) * max(0.0, min(bb, H) - max(t, 0.0))
+                if area > 0 and seen < area / 2 and not allow and layer is not None:
+                    seq = layer.parent if layer.parent is not None and layer.parent.raw.get("span") else None
+                    off.setdefault(seq.id if seq else lid, []).append((T, b["rect"], 1 - seen / area, layer))
+            elif b["type"] != "group" and not allow:
                 if rr < 0 or bb < 0 or l > W or t > H:
                     add("info", "offscreen", lid, T, "layer is visible but entirely off canvas", "check x/y")
         for i in range(len(texts)):
@@ -213,6 +226,17 @@ def check(src, step: float = 0.25, safe: float = 0.05) -> dict:
                     if ix * iy / area > 0.15:
                         add("warning", "text-overlap", f"{texts[i][0]}+{texts[j][0]}", T,
                             "two text layers overlap", "offset one of them or separate them in time")
+    for lid, seen in off.items():
+        if len({s[0] for s in seen}) * step < MEDIA_OFF_FOR:  # frames, once each where a sequence's clips overlap
+            continue
+        T, rect, share, layer = seen[0]
+        ty = layer.type
+        fix = ("a video or shader is placed by its top-left corner unless anchor says otherwise: set \"anchor\": "
+               "\"center\" to centre it on x and y, or move it inward"
+               if ty in ("video", "shader") and "anchor" not in layer.raw else
+               "move it inward, or set allowOffscreen if it is meant to be cut off")
+        add("warning", "media-offscreen", lid, T, f"{ty} box {rect} is {share:.0%} off the {W}x{H} canvas", fix,
+            until=seen[-1][0])
     # Contrast: render the frame without the text layer and its successors, compare luminance under its box.
     for layer in scene.all_layers():
         if layer.type not in ("text", "counter"):

{kinescript-1.3.0 → kinescript-1.3.1}/kinescript.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinescript
-Version: 1.3.0
+Version: 1.3.1
 Summary: Render motion graphics, video edits and voice-over from JSON scenes on the GPU, with checks an agent can read.
 Author: Dr. Know How
 License-Expression: MIT
@@ -135,13 +135,15 @@ Sounds are a top-level `audio` list, timed like layers and mixed by ffmpeg while
 - **Voice-over from text.** Write what a voice says in `text` and `kine voice` speaks it through a plugin, writing
   the file and its word times: [Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)
   (local, fast),
-  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local, tags,
+  [Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox) (local,
   cloned voices) or [ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs)
   (cloud, needs an API key), picked per sound with `backend`. `[[go]]` in the text names the next
   word, so a cue to `vo1:go` survives a rewrite of the line. Only a line whose text, speaker, rate, backend or
   options changed is spoken again, and rendering never calls a speech engine.
-- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell Chatterbox and ElevenLabs how to say
-  what follows. Tags are not words, so cues, marks and captions skip them, and Kokoro says the line without them.
+- **Delivery tags.** `[whispers]`, `[laughs]` or `[sighs]` in the text tell ElevenLabs how to say what follows.
+  Chatterbox takes them too but acts them only some of the time: in test takes it made a sound where `[laughs]`
+  goes in six of nine and whispered in none of seven. Tags are not words, so cues, marks and captions skip them,
+  and Kokoro says the line without them.
 - **A mix without listening.** Give a sound a `role` and it is set to that role's level: voice -18 LUFS, music
   -16, ambience -30, effects peaking at -6 dBFS. Music and ambience dip 14 dB while a voice speaks, an effect's
   leading silence is skipped so it lands on its cue, and the whole mix ends at -16 LUFS with peaks under
@@ -167,14 +169,20 @@ A narrated beat with a click on a marked word, over music that ducks under the v
 
 `kine voice scene.json` speaks it once. The
 [voice demo](https://drknowhow.github.io/kinescript/#sound) on the project site plays the result with sound, next
-to its scene file. The Kokoro plugin needs Python 3.10 to 3.12:
+to its scene file. Install the plugin for the voice you want next to Kinescript:
 
 ```bash
-pip install kinescript-kokoro
+pip install kinescript-kokoro       # local and fast; Python 3.10 to 3.12
+pip install kinescript-chatterbox   # local, copies a voice from a clip, tags hit or miss; installs PyTorch
+pip install kinescript-elevenlabs   # ElevenLabs' API, acts on tags; needs ELEVENLABS_API_KEY
 ```
 
-On a newer Python, install it into another one and point `KINE_VOICE_CMD` at it
-([details](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro)).
+A plugin can also live in another Python, for Kokoro on Python 3.13 or newer or to keep PyTorch out of
+Kinescript's environment: point `KINE_VOICE_CMD`, or `KINE_VOICE_CMD_<NAME>` for one backend, at it. Each plugin's
+README has the details:
+[Kokoro](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-kokoro),
+[Chatterbox](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-chatterbox),
+[ElevenLabs](https://github.com/drknowhow/kinescript/tree/main/plugins/kinescript-elevenlabs).
 
 ## Built for agents
 

{kinescript-1.3.0 → kinescript-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kinescript"
-version = "1.3.0"
+version = "1.3.1"
 description = "Render motion graphics, video edits and voice-over from JSON scenes on the GPU, with checks an agent can read."
 readme = "README.md"
 license = "MIT"

{kinescript-1.3.0 → kinescript-1.3.1}/tests/test_core.py

@@ -326,6 +326,36 @@ def test_check_flags_offscreen_text_and_overlap():
     assert "text-offscreen" in codes and "text-overlap" in codes and not res["ok"]
 
 
+def test_check_flags_media_mostly_off_canvas(clip):
+    # A video sits by its top-left corner, so x and y at the middle without an anchor push it off to the bottom right.
+    placed = {"id": "v", "type": "video", "src": clip, "x": "50%", "y": "50%", "w": 320, "h": 180, "dur": 2}
+    res = check(scene([placed], duration=2))
+    hit = [i for i in res["issues"] if i["code"] == "media-offscreen"]
+    assert len(hit) == 1 and hit[0]["layer"] == "v" and hit[0]["level"] == "warning" and "anchor" in hit[0]["fix"]
+    assert "75% off" in hit[0]["message"] and hit[0]["to"] - hit[0]["from"] >= 1.5
+    for fixed in ({"anchor": "center"}, {"allowOffscreen": True}):
+        res = check(scene([dict(placed, **fixed)], duration=2))
+        assert not [i for i in res["issues"] if i["code"] == "media-offscreen"], fixed
+    # A sequence's clips get its x, y and anchor, so they are reported once, as the sequence; its allowOffscreen
+    # covers them.
+    seq = {"id": "cut", "type": "sequence", "x": "50%", "y": "50%", "w": 320, "h": 180,
+           "clips": [{"src": clip, "trim": [0, 1.5]}, {"src": clip, "trim": [1.5, 3]}]}
+    res = check(scene([seq], duration=3))
+    hit = [i for i in res["issues"] if i["code"] == "media-offscreen"]
+    assert [i["layer"] for i in hit] == ["cut"] and hit[0]["to"] > 2.5
+    res = check(scene([dict(seq, allowOffscreen=True)], duration=3))
+    assert not [i for i in res["issues"] if i["code"] == "media-offscreen"]
+
+
+def test_check_lets_media_pass_through_the_edge():
+    # Sliding in from off the canvas is mostly off for under a second, which is not a misplaced layer.
+    shader = {"id": "s", "type": "shader", "preset": "score", "w": 320, "h": 180, "dur": 2}
+    res = check(scene([dict(shader, x=[[0, -320], [0.5, 0, "outCubic"]])], duration=2))
+    assert not [i for i in res["issues"] if i["code"] == "media-offscreen"]
+    res = check(scene([dict(shader, x=-240)], duration=2))  # left there, the same layer is flagged
+    assert [i["layer"] for i in res["issues"] if i["code"] == "media-offscreen"] == ["s"]
+
+
 def test_check_flags_low_contrast():
     res = check(scene([{"id": "a", "type": "text", "text": "Grey", "x": 160, "y": 90, "size": 30, "fill": "#20232a"}],
                       bg="#1b1d22", duration=2))
@@ -359,6 +389,16 @@ def test_theme_names_work_inside_a_scenes_own_components():
     assert [(s.by_id[i].raw["fill"], s.by_id[i].raw["stroke"]) for i in ("t1-w", "t2-w")] == [("#9299a8", "#123456")] * 2
 
 
+def test_a_component_holding_a_group_can_be_used_twice():
+    spec = scene([{"use": "card", "id": "a", "label": "A"}, {"use": "card", "id": "ab", "label": "B"}])
+    spec["components"] = {"card": {"params": {"label": ""}, "layers": [
+        {"id": "box", "type": "group", "children": [{"id": "abc", "type": "text", "text": "{{label}}"},
+                                                    {"type": "group", "children": [{"id": "dot", "type": "circle", "r": 4}]}]}]}}
+    s = k.Scene(spec)
+    assert {"a-box", "a-abc", "a-dot", "ab-box", "ab-abc", "ab-dot"} <= set(s.by_id)
+    assert s.by_id["ab-abc"].raw["text"] == "B"
+
+
 def test_sequence_crossfades_and_video_renders(clip):
     spec = scene([{"type": "sequence", "id": "cut", "clips": [{"src": clip, "trim": [0, 1.5]}, {"src": clip, "trim": [1, 3]}],
                    "transition": {"type": "fade", "dur": 0.5}}])