Changing designs

Three ways to change what is there, from smallest to largest.

#Read it back first

source prints a layer as you would write it: the shortest form, with containers as {"row": [...]}, plain texts as strings, the font and color a container passes down lifted back to it, kit colors and styles by name, instances as {"Component": {...}}.

$ facet source Library
{"row":[{"Raga/Card":null},{"Raga/Card":{"State":"New","Hour":"AFTERNOON","Name":"राग भीमपलासी"}},{"Raga/Card":{"State":"Locked","Hour":"LATE NIGHT","Name":"राग मालकौंस"}}],"gap":20,"name":"Library","at":[1020,0]}

--depth N stops after N levels and counts the children it left out.

source prints what is there. Parts come back expanded, because a part leaves no link, and values equal to their defaults are left out. So for a screen you built from parts, keep editing your own JSON and send it with --sync; read with source what you did not write, or what someone changed by hand. A kit tint prints as you write it (@rose/20%).

#Sync

build --sync matches what you write against the existing tree and changes only what differs:

• a written node matches the existing child with the same key or name (unnamed nodes match the next unnamed child of the same kind; several children with the same name match in order, so give repeated parts a key);
• a match of the same kind is updated in place; a match of another kind, and anything new, is built;
• existing children that nothing matches are deleted;
• children end in the written order.

Keys you write are applied. A key you leave out keeps its value; write "none" to clear a fill or stroke. The whole sync is one undo step, and the reply counts what it did: Synced: 2 changed, 1 added, 0 removed (14 already as written). --preview renders the synced tree as it does a build.

To add one child, build @child.json --parent ID appends it last in its parent. To put it anywhere else, sync the parent with the child where it belongs.

#Modify

modify takes the same keys as a node, for one layer and, with $nodes, its named descendants:

facet --doc f.facet modify Card '{"fill": "@paper", "$nodes": {"Title": {"text": "Tuesday", "font": "Inter 20/26 700"}}}'

#Replace a set

build @set.json --replace builds the set again in the old one's place. Instances move to the new variants with the same names and keep the properties they set.