fix: document safe template default editing

This commit is contained in:
James
2026-08-25 06:54:02 +00:00
parent 1e11608d44
commit 71e8e92ae9
9 changed files with 36 additions and 0 deletions
@@ -15,6 +15,10 @@ Only defaults declared in `data-composition-variables` are editable:
Keep replacement copy within 20% of the original length.
## Safe editing mechanics
Call `set_template_variable_defaults` once with the existing variable ids and their new defaults. Do not directly edit or rewrite `index.html` or its `data-composition-variables` attribute; the imported declaration is HTML-entity-encoded JSON and the setter preserves that encoding. Never edit `__template_baseline__.html` or a duplicate composition file. For an image slot, pass only the token returned by an image tool. Validate after the setter succeeds.
## Protected
Preserve the share-sheet palette, typography, buttons, geometry, carousel layout, scene structure, duration, timing, easing, and tap animation. Do not replace any image outside the declared slide and logo slots, and do not recolor the operating-system interface.