Operazioni sul design system

Promote authored component overrides to a reusable variant and reattach the node.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Write one token ({ set, path, type, value }), under the AA contrast gate and the token group rules. A dimension token (a type.*.fontSize, a space step, a radius) may be fluid: its value may be a clamp(), calc(), min() or max(), such as clamp(2.125rem, 1.2rem + 3.9vw, 6.4rem). A fluid size suits pages on a breakpoint frame; on a page whose frame scales (responsiveMode: "scale") the canvas already scales, so a vw size there scales twice. To scale spacing, write a scale factor instead of every step: a number token named scale in a space group multiplies every dimension of that group and its subgroups (space.section-y.scale: 0.75 makes every section spacing 25 % tighter, space.scale scales all spacing; above 0).

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Write many tokens as one change, gated once for AA contrast on the end state, so one undo restores the lot. A dimension token (a type.*.fontSize, a space step, a radius) may be fluid: its value may be a clamp(), calc(), min() or max(), such as clamp(2.125rem, 1.2rem + 3.9vw, 6.4rem). A fluid size suits pages on a breakpoint frame; on a page whose frame scales (responsiveMode: "scale") the canvas already scales, so a vw size there scales twice. To scale spacing, write a scale factor instead of every step: a number token named scale in a space group multiplies every dimension of that group and its subgroups (space.section-y.scale: 0.75 makes every section spacing 25 % tighter, space.scale scales all spacing; above 0).

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Set cells of one design-system component in one save: each { cell, value }, the cell key <variant>.<size>.<state>.<part>.<breakpoint>.<property> (primary.all.hover.container.base.background: all when the value does not vary by size, base or a breakpoint id). A value is a token alias such as {color.bg.accent} (a semantic or foundation token, never a palette step or a raw literal), a bare keyword for a property whose values are modes (a link underline's none, always, hover), or { component, variant } for a part that embeds another component. Read the cell keys of a component with the component/<key> resource (designSystem.readComponent) and the segments with designSystem.read components: true. The menu dialog's drawer is the drawer-nav component: its overlay cells (background, opacity, blur), panel cells (background, width, padding, shadow, z, radius, offset-x, offset-y, fit) and motion cells (delay, duration, easing, fade) style it, such as full.all.default.overlay.base.blur. Every save runs the AA contrast gate.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Add a variant to a design-system component, such as a light or a small button, a pill tag or a dark card: variant (its key, kebab case), label, and from, the variant whose cells it copies as the same aliases, so the new one follows the system until one of its cells changes. Change its cells with setComponentCell and draw it on a node with tree.commit set_variant { id, variant }. Under the AA contrast gate.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Add a theme ({ key, label, sets in precedence order, activation? }) as a draft, under the AA contrast gate: the previews show it, and a publish ships it only where a node names it (node theme, an instance's $theme, a data-theme attribute; the publish answer lists it in draftThemes). A draft's activation rule never applies on the public site: clear the draft flag with updateTheme to make the theme live by its rule.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Add a token set to the sets of a theme (theme, set): the set takes its place in the precedence order the sets follow, so there is no position to choose, and its tokens apply wherever the theme does. Under the AA contrast gate.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Set the design-system theme a page node and its subtree draw in (pageId, nodeId, theme; null makes the node inherit its parent's again), as tree.commit set_theme does: the write goes through the tree commit's gates and needs the page's tree:<pageId> base revision.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Remove site overrides so the blueprint's values apply again, in one revision. scope names what: { kind: "all" }, one token ({ set, path }), every token under a path prefix, a component, some cells of a component, a variant, a theme, a site set, or many of these. A token the site added is deleted, which is refused (409) while a cell still aliases it.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Vuole confirmed: ["destructive"] sul batch, che la forma della CLI per una sola operazione non imposta: mettila in un file di batch ed esegui yarn splash apply <file> --dry-run.

Import tokens from DTCG files in the Tokens Studio layout (one file per set plus $themes, loose or zipped as base64) or from a Figma variables export (collections become sets, modes themes); mapping renames imported paths to existing ones. Run it as a dry run first: the answer's report lists the adds, the changes, the type conflicts and the unknown names, and nothing is written. A confirmed import lands as one revision under the AA contrast gate.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Read every override the draft holds over its blueprint (tokens, cells, variants, themes, sets, mixins). Over MCP it answers a summary (their count and names, the stylesheet's size); pass full: true for every override with its blueprint and site values, and the stylesheet.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Check the draft design system: every contrast pair below AA or AAA, the pairs that cannot be judged, the missing media assets and the lint rules' findings, with the draft's overrides. Over MCP it answers a summary (counts by severity and reason, the worst findings first, the override names, the stylesheet's size); pass full: true for every finding, every override and the stylesheet.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Add an empty token set key after set after in the precedence order. No theme uses it until activateSet or updateTheme lists it.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Edit a theme: its label, its sets in precedence order, its activation rule, isDefault (the former default stops being it; a default takes no rule and is never a draft) or draft. draft: false makes the theme live: published wherever its rule applies or a node names it. A draft theme is published only where a node names it.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Relabel a component variant or hide it (hidden: true): a hidden variant still draws wherever a node uses it, and the pickers leave it out.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Delete a variant the site added, with its cells. A variant the blueprint ships is refused (hide it with updateVariant), and so is one a cell or a node uses (409, with the usage).

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Vuole confirmed: ["destructive"] sul batch, che la forma della CLI per una sola operazione non imposta: mettila in un file di batch ed esegui yarn splash apply <file> --dry-run.

Create or update a mixin, a surface nodes apply by key with tree.commit set_mixins (a pattern background, a card surface): key, label and sheet, CSS property to value in the order written, with tokens as {path}. The sheet takes the properties of the style catalogue, no !important, and semantic or foundation tokens of a group the property takes, each defined in some theme of the draft.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Delete a mixin the site added. A mixin the blueprint ships is refused, and so is one a draft node applies (the refusal names the nodes).

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Vuole confirmed: ["destructive"] sul batch, che la forma della CLI per una sola operazione non imposta: mettila in un file di batch ed esegui yarn splash apply <file> --dry-run.

Read the draft design system's index: its revision, sets, themes, every component with its variant keys, and every token group with its number of paths. Ask for more with tokens (the groups whose paths and values to include, such as ["color.palette", "space"]), components: true (each component's sizes, states and parts, the segments of a setComponentCell key), css: true (the compiled stylesheet, about 240 KB on a large site) or embeds: true. The default answer stays small; read one component's cells with designSystem.readComponent.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.

Read the cells of one design-system component, filtered and paged: variant, size, state, part, breakpoint and property keep the cells whose key segment equals them (a cell key is <variant>.<size>.<state>.<part>.<breakpoint>.<property>), and own: true keeps only the cells set at their own key, leaving out the inherited ones. Each cell has its own value (null when it inherits), the key it inherits from and the blueprint's value; resolved: true adds its value in every theme, css: true the blueprint's baseline stylesheet. limit cells (100 by default) from cursor; total counts every match and nextCursor names the next page. A large component has thousands of cells: filter by variant and state first.

I campi più annidati sono nello schema di output che risponde discover_operations con outputSchemas: true.