Contract backed
Schemas, manifest metadata, editor fields, accessibility, and i18n remain attached to the block type.
- 1 registered contract
- Ensemble schema id
- Editor category metadata
Block documentation
Estimator Calculator
Explore tax-estimator as a composable block: contract metadata, multiple configuration defaults, and every theme recipe rendered against the same sample content.
10 configurations19 recipes4 data recipesnative
Grade A defaults
Quality evidence for this block
Runtime rendered
The documentation route renders through native, alias, wrapped, or nonvisual runtime support without generic fallback UI.
- native
- Visible runtime preview
Configuration coverage
Default, media, background, gradient, colorway, dense, and editorial configurations are all visible.
- 10 configuration previews
- Cloud Elephants colorways
- image, background, gradient, dense, editorial
Recipe coverage
Every Theme Studio recipe has a focused page and an inline preview for this block.
- 19 recipe previews
- focused recipe routes
- previous and next recipe navigation
Data composition
CMS authors can lift structured payload recipes for default, media, operator, and stress contexts.
- 4 cloneable data recipes
- composition_recipe metadata
- composition passports
- visual polish checks
- default provenance maps
- content edit bundles
- recipe compatibility maps
- cloneable payloads
State readiness
Default, empty, pending, active, invalid, and disabled states are documented for every cloneable block recipe.
- 24 state readiness entries
- default, empty, pending, active, invalid, disabled
- all recipe states documented
Resilience proof
Media replacement, long copy, and awkward content tolerance are represented in the documented defaults.
- replaceable Cloud Elephants media
- long-copy tolerance
- awkward-content tolerance
Configurations
Default, media, background, gradient, Cloud Elephants colorways, dense, and editorial treatments
Default
Polished SaaSDefault
Baseline contract props with the selected recipe and standard system preset.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Placeholder Image
Polished SaaS GrowthImage
Shows the block alongside Cloud Elephants placeholder media so image, card, and media spacing are visible.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Background Image
Glass ProductBackground
Places the component on a Cloud Elephants image-backed documentation frame for hero, CTA, and overlay-style review.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Gradient Accent
Bold LaunchGradient
Uses a strong gradient shell to prove contrast, buttons, and panels in energetic brand treatments.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
CE Deep Sky
Bold LaunchBackground
Electric blue, coral, and deep navy for launch and high-contrast hero treatments.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
CE Aqua Operator
Polished SaaS CrispImage
Aqua, white, ink, and operator blue for service, contact, and listing pages.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
CE Coral Launch
Bold LaunchImage
Coral, magenta, electric blue, and warm white for announcements and campaign pages.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
CE Ink Mist
Editorial Block SystemEditorial
Mist, ink, slate, blue, and coral for editorial and proof-heavy surfaces.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Dense Ops
Compact OpsDense
Compact operator layout with dashboard-style controls and tighter spacing.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Editorial Story
Editorial Block SystemEditorial
Roomier narrative treatment for content, FAQ, testimonials, and feature blocks.
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Data recipes
Composable CMS payloads for default, media-ready, compact operator, and long-copy stress contexts
Minimal Default
Polished SaaSdefault
Smallest useful CMS payload with the block type, stable id, editable props, and recipe-aware appearance.
Component anatomy
5 regionsMinimal Default anatomy
Surfaceouter layout and background
tax-estimator uses recipe surface tokens to keep the outer frame styled and composable.
background, panel, panelElevated, borderCopyheadings, body copy, labels, and supporting text
Copy fields map to primary and muted text roles so editors can change words without restyling the block.
text, textMutedActionsCTA, link, event, and navigation affordances
Action regions use recipe button and accent tokens while preserving href or event payloads.
button, buttonText, signal, uplinkControlsinputs, choices, form fields, and operator controls
Control regions keep labels, required state, and options aligned with recipe control tokens.
control, controlText, borderFeedbackstatus, validation, selected, loading, and disabled evidence
Feedback regions tie state-readiness evidence to visible recipe status treatments.
badge, badgeText, signalRecipe passport
mediumMinimal Default passport
Use when a tax-estimator block should land quickly with balanced Polished SaaS defaults.
Minimal Default is a medium-complexity quick-start recipe with 5 documented composition slots.
3 required regions, 2 optional regions.
Slots
Surface / 0/1Copy / 5/5Actions / 1/1Controls / 4/6Feedback / 0/0
Replacement guidance
- Keep Polished SaaS recipe tokens as the source of visual styling for the surface, text, controls, and actions.
- No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.
- Verify each action keeps either a valid href or canonical event name plus an editor-visible label.
- Verify control labels, required state, choices, and submission metadata before publishing.
- The recipe does not require repeatable collection editing.
Publish checklist
- Validate tax-estimator against its block contract before publishing.
- 3 required anatomy regions remain present: surface, copy, feedback.
- 15/16 builder fields are CMS-editable or intentionally locked.
- Interactive labels, target size, href/event wiring, and disabled states have been reviewed.
- Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.
- Contrast checks meet the AA recipe target.
Recipe fit
6 axesMinimal Default recipe fit
Page contextpage / primary
funnelcontactservice-page
tax-estimator is best composed into funnel, contact, service-page.
3 page types mapped for tax-estimator.Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.Section rolelayout / primary
conversioncontentform-controls
tax-estimator can act as conversion, content, form-controls within a composed page.
5 anatomy regions produce 3 section roles.Place the block where its required anatomy regions have enough room before compressing it into dense page slots.Content modelcontent / supporting
copy-ledcta-ledinput-led
Minimal Default composition passport is copy-led, cta-led, input-led for CMS composition.
15/16 fields are editable across 3 content models.Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.Interaction modelinteraction / primary
primary-linknumberselect
tax-estimator carries primary-link, number, select interaction affordances.
1 action surface and 2 control surfaces mapped.Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.Authoring fitauthoring / specialized
quick-startmedium-complexity6-high-care-replacements
tax-estimator uses quick-start authoring with medium complexity.
16 default provenance items with 6 high-care replacements.Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.Responsive fitresponsive / primary
single-column stacktwo-column adaptive gridresponsive composition gridmin-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.
tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages.
3 responsive behavior maps cover phone, tablet, and desktop composition.Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.Visual polish
6/6Minimal Default visual polish
Surface rhythmlayout
tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers.
default treatment uses comfortable density and 14px radius base.background, panel, panelElevated, borderType hierarchytypography
Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text.
6/6 contrast checks pass the AA target.text, textMuted, badgeTextAction clarityinteraction
Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options.
1 action surface and 2 control surfaces mapped.button, buttonText, control, controlText, signal, uplinkMedia treatmentmedia
The recipe remains polished without requiring placeholder media or visual assets inside this block.
No media region is required for this recipe.panelElevated, border, textMutedState feedbackstate
Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning.
6 state-readiness entries include default, empty, pending, active, invalid, disabled.badge, badgeText, signalResponsive balanceresponsive
Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe.
single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.panel, border, controlDefault provenance
16 fieldsMinimal Default default provenance
collection-itemlocked-tokenrequires-action-targetrequires-control-optionssafe-to-edit
- Appearanceappearance
Keep visual styling aligned to Polished SaaS recipe tokens unless the recipe itself changes.
Polished SaaS recipe tokens - Titletitle
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Descriptiondescription
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Modemode
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Inputsinputs
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Labelinputs[].label
Preserve control labels, required state, choices, submission metadata, and validation copy.
cloneable block recipe payload - Inputs Item Typeinputs[].type
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Valueinputs[].value
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Unitinputs[].unit
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Outputsoutputs
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Outputs Item Labeloutputs[].label
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Valueoutputs[].value
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Descriptionoutputs[].description
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Assumptionsassumptions
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Connect Ctaconnect_cta
Keep the label paired with a valid href or canonical postEvent event name before publishing.
CMS route, URL, or canonical postEvent path - Disclaimerdisclaimer
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload
Edit bundles
5 bundlesMinimal Default edit bundles
Copy bundlerequired / repeatable-items
descriptioninputs[].labeloutputs[].descriptionoutputs[].labeltitle
Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.Action bundlerecommended / single-field
connect_cta
Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
CMS route, URL, or canonical postEvent pathKeep the label paired with a valid href or canonical postEvent event name before publishing.Control bundlerecommended / repeatable-items
inputsinputs[].typeinputs[].unitinputs[].value
Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish.
CMS form schema or tenant data-capture defaultsPreserve control labels, required state, choices, submission metadata, and validation copy.Style bundleguarded / guarded-system
appearance
Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
Polished SaaS recipe tokensKeep visual styling aligned to Polished SaaS recipe tokens unless the recipe itself changes.Content bundlerequired / repeatable-items
assumptionsdisclaimermodeoutputsoutputs[].value
Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.CMS composition
16 fieldsMinimal Default fields
actioncontentcopyformstyle
- Appearanceappearance
- Titletitle
- Descriptiondescription
- Modemode
- Inputsinputs
- Inputs Item Labelinputs[].label
- Inputs Item Typeinputs[].type
- Inputs Item Valueinputs[].value
- Inputs Item Unitinputs[].unit
- Outputsoutputs
- Outputs Item Labeloutputs[].label
- Outputs Item Valueoutputs[].value
- Outputs Item Descriptionoutputs[].description
- Assumptionsassumptions
- Connect Ctaconnect_cta
- Disclaimerdisclaimer
CMS editing
15/16 editableMinimal Default editor guidance
Copytext/rich-text editor
Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.
cloneable block recipe payloadActionlink or event action editor
Actions should resolve to a URL or event name with a human-readable label.
CMS route, URL, or canonical postEvent pathFormform schema and input editor
Form fields should preserve labels, required state, options, and submission metadata.
CMS form schema or tenant data-capture defaultsStyleappearance preset selector
Style fields should prefer recipe or appearance tokens over one-off inline values.
Polished SaaS recipe tokensContentplain content field
Content should remain serializable JSON and preserve the documented block contract.
cloneable block recipe payloadDefault states
6 statesMinimal Default state readiness
DefaultInitial render with the cloneable recipe payload
Polished SaaS tokens with default documentation treatment
The Polished SaaS recipe renders a contract-safe primary state for tax-estimator.EmptyRepeatable collections have zero items
Reserved panel space with fallback copy or placeholder media
Repeatable fields are documented for add, remove, reorder, and item-level editing.PendingAsync assignment, embed load, or form submission is in flight
Neutral reserved frame with status copy and no layout shift
Async-capable props are mapped through controls, events, or provider placeholders.ActiveSelected action, active link, checked input, or open disclosure
Signal/uplink emphasis with visible selected-state chips
1 action surface and 2 control surfaces are mapped for selected-state review.InvalidRequired input, option, or submitted value is invalid
Warning/danger status treatment while preserving the block frame
Form controls preserve labels, required state, options, and submission metadata.DisabledUnavailable action or temporarily disabled control
Muted affordance with preserved label, spacing, and hit-area rhythm
Interactive maps preserve labels and control roles so disabled states can stay understandable.Controls and actions
3 surfacesMinimal Default actions and controls
primarynumberselect
Actions
- Request reviewconnect_cta
Controls
- Filing or project sizeinputs[0]
- Timinginputs[1]
Recipe styling
15 tokensMinimal Default style tokens
Page background#f7fbff
Panel surface#ffffff
Elevated surface#ffffff
Primary text#142033
Muted text#526174
Signal accent#166bff
Secondary accent#00a6a6
Border#d6dee8
Control surface#ffffff
Control text#142033
Button surface#166bff
Button text#ffffff
Badge surface#eef5ff
Badge text#174ea6
Font familyInter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
Readability
6/6Minimal Default contrast checks
Text on background15.73:1 / AAA
Text on panel16.35:1 / AAA
Muted text on panel6.32:1 / AA
Button text on button4.58:1 / AA
Control text on control16.35:1 / AAA
Badge text on badge7.15:1 / AAA
Accessibility proof
WCAG 2.2 AAMinimal Default accessibility checks
Semantic structuresemantics / required
tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview.
runtime block sections, cards, lists, and headingsKeyboard and tap targetskeyboard / required
Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances.
mapped actions/controls render as native focusable surfacesText alternativesmedia / contextual
Recipes without media do not leave decorative media shells that need alt text.
media slots collapse when unusedControl labelsforms / required
Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review.
control map includes required field labels and option metadataStatus and motionstate / required
Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present.
runtime evidence avoids hidden status-only contentResponsive proof
3 viewportsMinimal Default responsive behavior
Phone390px / single-column stack
Polished SaaS stacks tax-estimator into one phone column with comfortable spacing and bounded content.
min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.Tablet768px / two-column adaptive grid
Polished SaaS adapts tax-estimator to 2 tablet columns before expanding to the desktop layout.
tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.Desktop1366px / responsive composition grid
Polished SaaS gives tax-estimator up to 2 desktop columns while preserving recipe spacing.
desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Structured payload
{
"id": "block-doc-tax-estimator-data-minimal-default",
"block_type": "tax-estimator",
"props": {
"appearance": {
"preset": "shadcn"
},
"title": "Tax planning estimator",
"description": "A static estimator surface for inputs, outputs, assumptions, and review handoff.",
"mode": "tax",
"inputs": [
{
"label": "Filing or project size",
"type": "number",
"value": "2",
"unit": "units"
},
{
"label": "Timing",
"type": "select",
"value": "This quarter",
"options": [
"This quarter",
"Next quarter"
]
}
],
"outputs": [
{
"label": "Estimated range",
"value": "$1,200-$2,400",
"description": "Demo-only range based on local assumptions."
},
{
"label": "Review needed",
"value": "Human confirmation required",
"description": "Final numbers require provider review."
}
],
"assumptions": [
"Uses example content only",
"No submission or stored calculation is created"
],
"connect_cta": {
"text": "Request review",
"href": "#block-preview"
},
"disclaimer": "This estimator is informational and does not provide binding advice, pricing, or eligibility."
},
"block_order": 1,
"metadata": {
"composition_recipe": {
"id": "minimal-default",
"intent": "default",
"label": "Minimal Default",
"recipe": "polished-saas",
"source": "block-explorer",
"quality_proof": [
"composition"
],
"composition_passport": {
"id": "minimal-default",
"label": "Minimal Default composition passport",
"intent": "default",
"recipe": "polished-saas",
"authoring_mode": "quick-start",
"complexity": "medium",
"fit": "Use when a tax-estimator block should land quickly with balanced Polished SaaS defaults.",
"required_regions": [
"surface",
"copy",
"feedback"
],
"optional_regions": [
"actions",
"controls"
],
"slots": [
{
"id": "surface",
"label": "Surface",
"required": true,
"field_count": 1,
"editable_count": 0,
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"required": true,
"field_count": 5,
"editable_count": 5,
"token_roles": [
"text",
"textMuted"
],
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"required": false,
"field_count": 1,
"editable_count": 1,
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"required": false,
"field_count": 6,
"editable_count": 4,
"token_roles": [
"control",
"controlText",
"border"
],
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"required": true,
"field_count": 0,
"editable_count": 0,
"token_roles": [
"badge",
"badgeText",
"signal"
],
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"builder_field_count": 16,
"editable_field_count": 15,
"action_count": 1,
"control_count": 2,
"replacement_guidance": [
"Keep Polished SaaS recipe tokens as the source of visual styling for the surface, text, controls, and actions.",
"No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.",
"Verify each action keeps either a valid href or canonical event name plus an editor-visible label.",
"Verify control labels, required state, choices, and submission metadata before publishing.",
"The recipe does not require repeatable collection editing."
],
"publish_checklist": [
"Validate tax-estimator against its block contract before publishing.",
"3 required anatomy regions remain present: surface, copy, feedback.",
"15/16 builder fields are CMS-editable or intentionally locked.",
"Interactive labels, target size, href/event wiring, and disabled states have been reviewed.",
"Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.",
"Contrast checks meet the AA recipe target."
],
"agent_notes": [
"Prefer editing props fields described by the builder field map; metadata is evidence, not primary content.",
"Preserve recipe_alignment token roles unless the page theme or recipe changes intentionally.",
"Use the anatomy slots to compose or replace content without changing the block type."
],
"summary": "Minimal Default is a medium-complexity quick-start recipe with 5 documented composition slots."
},
"composition_passport_complexity": "medium",
"composition_passport_authoring_mode": "quick-start",
"composition_passport_slots": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"composition_passport_check_count": 6,
"visual_polish_check_count": 6,
"visual_polish_pass_count": 6,
"visual_polish_checks": [
{
"id": "surface-rhythm",
"label": "Surface rhythm",
"axis": "layout",
"status": "ready",
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"evidence": "default treatment uses comfortable density and 14px radius base.",
"summary": "tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers."
},
{
"id": "type-hierarchy",
"label": "Type hierarchy",
"axis": "typography",
"status": "ready",
"token_roles": [
"text",
"textMuted",
"badgeText"
],
"evidence": "6/6 contrast checks pass the AA target.",
"summary": "Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text."
},
{
"id": "action-clarity",
"label": "Action clarity",
"axis": "interaction",
"status": "ready",
"token_roles": [
"button",
"buttonText",
"control",
"controlText",
"signal",
"uplink"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"summary": "Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options."
},
{
"id": "media-treatment",
"label": "Media treatment",
"axis": "media",
"status": "ready",
"token_roles": [
"panelElevated",
"border",
"textMuted"
],
"evidence": "No media region is required for this recipe.",
"summary": "The recipe remains polished without requiring placeholder media or visual assets inside this block."
},
{
"id": "state-feedback",
"label": "State feedback",
"axis": "state",
"status": "ready",
"token_roles": [
"badge",
"badgeText",
"signal"
],
"evidence": "6 state-readiness entries include default, empty, pending, active, invalid, disabled.",
"summary": "Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning."
},
{
"id": "responsive-balance",
"label": "Responsive balance",
"axis": "responsive",
"status": "ready",
"token_roles": [
"panel",
"border",
"control"
],
"evidence": "single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.",
"summary": "Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe."
}
],
"visual_polish_axes": [
"layout",
"typography",
"interaction",
"media",
"state",
"responsive"
],
"default_provenance_count": 16,
"default_provenance_map": [
{
"path": "appearance",
"label": "Appearance",
"field_role": "style",
"value_type": "object",
"editable": false,
"repeated": false,
"default_source": "Polished SaaS recipe tokens",
"replacement_policy": "locked-token",
"replacement_risk": "medium",
"guardrail": "Keep visual styling aligned to Polished SaaS recipe tokens unless the recipe itself changes.",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"summary": "Appearance defaults from Polished SaaS recipe tokens; replacement is medium risk with locked-token policy."
},
{
"path": "title",
"label": "Title",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Title defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "description",
"label": "Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Description defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "mode",
"label": "Mode",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Mode defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "inputs",
"label": "Inputs",
"field_role": "form",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Inputs Item Label defaults from cloneable block recipe payload; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Type defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Value defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Unit defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "outputs",
"label": "Outputs",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs Item Value defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "assumptions",
"label": "Assumptions",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Assumptions defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"field_role": "action",
"value_type": "object",
"editable": true,
"repeated": false,
"default_source": "CMS route, URL, or canonical postEvent path",
"replacement_policy": "requires-action-target",
"replacement_risk": "high",
"guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"summary": "Connect Cta defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Disclaimer defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
}
],
"default_replacement_policies": [
"collection-item",
"locked-token",
"requires-action-target",
"requires-control-options",
"safe-to-edit"
],
"default_replacement_risks": [
"high",
"low",
"medium"
],
"default_replacement_high_risk_count": 6,
"content_edit_bundle_count": 5,
"content_edit_bundles": [
{
"id": "copy",
"label": "Copy bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Preserve control labels, required state, choices, submission metadata, and validation copy.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"type hierarchy",
"mobile wrapping"
],
"summary": "Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "actions",
"label": "Action bundle",
"intent": "recommended",
"edit_mode": "single-field",
"field_paths": [
"connect_cta"
],
"default_sources": [
"CMS route, URL, or canonical postEvent path"
],
"guardrails": [
"Keep the label paired with a valid href or canonical postEvent event name before publishing."
],
"depends_on": [
"copy labels",
"href or event target",
"state readiness"
],
"summary": "Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "controls",
"label": "Control bundle",
"intent": "recommended",
"edit_mode": "repeatable-items",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value"
],
"default_sources": [
"CMS form schema or tenant data-capture defaults"
],
"guardrails": [
"Preserve control labels, required state, choices, submission metadata, and validation copy."
],
"depends_on": [
"field labels",
"required state",
"disabled state"
],
"summary": "Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "style",
"label": "Style bundle",
"intent": "guarded",
"edit_mode": "guarded-system",
"field_paths": [
"appearance"
],
"default_sources": [
"Polished SaaS recipe tokens"
],
"guardrails": [
"Keep visual styling aligned to Polished SaaS recipe tokens unless the recipe itself changes."
],
"depends_on": [
"theme recipe tokens",
"contrast proof"
],
"summary": "Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "content",
"label": "Content bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"assumptions",
"disclaimer",
"mode",
"outputs",
"outputs[].value"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"contract-safe JSON"
],
"summary": "Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
}
],
"content_edit_bundle_ids": [
"copy",
"actions",
"controls",
"style",
"content"
],
"content_edit_bundle_modes": [
"guarded-system",
"repeatable-items",
"single-field"
],
"content_edit_bundle_required_count": 2,
"content_edit_bundle_guarded_count": 1,
"recipe_compatibility_count": 6,
"recipe_compatibility_map": [
{
"id": "page-context",
"label": "Page context",
"axis": "page",
"fit": "primary",
"values": [
"funnel",
"contact",
"service-page"
],
"evidence": "3 page types mapped for tax-estimator.",
"guardrail": "Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.",
"summary": "tax-estimator is best composed into funnel, contact, service-page."
},
{
"id": "section-role",
"label": "Section role",
"axis": "layout",
"fit": "primary",
"values": [
"conversion",
"content",
"form-controls"
],
"evidence": "5 anatomy regions produce 3 section roles.",
"guardrail": "Place the block where its required anatomy regions have enough room before compressing it into dense page slots.",
"summary": "tax-estimator can act as conversion, content, form-controls within a composed page."
},
{
"id": "content-model",
"label": "Content model",
"axis": "content",
"fit": "supporting",
"values": [
"copy-led",
"cta-led",
"input-led"
],
"evidence": "15/16 fields are editable across 3 content models.",
"guardrail": "Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.",
"summary": "Minimal Default composition passport is copy-led, cta-led, input-led for CMS composition."
},
{
"id": "interaction-model",
"label": "Interaction model",
"axis": "interaction",
"fit": "primary",
"values": [
"primary-link",
"number",
"select"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"guardrail": "Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.",
"summary": "tax-estimator carries primary-link, number, select interaction affordances."
},
{
"id": "authoring-fit",
"label": "Authoring fit",
"axis": "authoring",
"fit": "specialized",
"values": [
"quick-start",
"medium-complexity",
"6-high-care-replacements"
],
"evidence": "16 default provenance items with 6 high-care replacements.",
"guardrail": "Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.",
"summary": "tax-estimator uses quick-start authoring with medium complexity."
},
{
"id": "responsive-fit",
"label": "Responsive fit",
"axis": "responsive",
"fit": "primary",
"values": [
"single-column stack",
"two-column adaptive grid",
"responsive composition grid",
"min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke."
],
"evidence": "3 responsive behavior maps cover phone, tablet, and desktop composition.",
"guardrail": "Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.",
"summary": "tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages."
}
],
"recipe_compatibility_axes": [
"page",
"layout",
"content",
"interaction",
"authoring",
"responsive"
],
"recipe_compatibility_page_types": [
"funnel",
"contact",
"service-page"
],
"recipe_compatibility_section_roles": [
"conversion",
"content",
"form-controls"
],
"recipe_compatibility_fits": [
"primary",
"specialized",
"supporting"
],
"builder_field_count": 16,
"builder_field_map": [
{
"path": "appearance",
"label": "Appearance",
"value_type": "object",
"role": "style",
"editable": false,
"repeated": false,
"summary": "Appearance is a object field used for style."
},
{
"path": "title",
"label": "Title",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Title is a string field used for copy."
},
{
"path": "description",
"label": "Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Description is a string field used for copy."
},
{
"path": "mode",
"label": "Mode",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Mode is a string field used for content."
},
{
"path": "inputs",
"label": "Inputs",
"value_type": "array",
"role": "form",
"editable": true,
"repeated": false,
"summary": "Inputs is a array field used for form."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Inputs Item Label is a string collection field used for copy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Type is a string collection field used for form."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Value is a string collection field used for form."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Unit is a string collection field used for form."
},
{
"path": "outputs",
"label": "Outputs",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Outputs is a array field used for content."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Label is a string collection field used for copy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": true,
"summary": "Outputs Item Value is a string collection field used for content."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Description is a string collection field used for copy."
},
{
"path": "assumptions",
"label": "Assumptions",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Assumptions is a array field used for content."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"value_type": "object",
"role": "action",
"editable": true,
"repeated": false,
"summary": "Connect Cta is a object field used for action."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Disclaimer is a string field used for content."
}
],
"editor_guidance_count": 5,
"editor_guidance_map": [
{
"id": "copy",
"label": "Copy",
"field_role": "copy",
"field_count": 5,
"editable_count": 5,
"editor_widget": "text/rich-text editor",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"default_source": "cloneable block recipe payload",
"summary": "Copy fields use the text/rich-text editor across 5/5 editable fields."
},
{
"id": "action",
"label": "Action",
"field_role": "action",
"field_count": 1,
"editable_count": 1,
"editor_widget": "link or event action editor",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"default_source": "CMS route, URL, or canonical postEvent path",
"summary": "Action fields use the link or event action editor across 1/1 editable field."
},
{
"id": "form",
"label": "Form",
"field_role": "form",
"field_count": 4,
"editable_count": 4,
"editor_widget": "form schema and input editor",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"default_source": "CMS form schema or tenant data-capture defaults",
"summary": "Form fields use the form schema and input editor across 4/4 editable fields."
},
{
"id": "style",
"label": "Style",
"field_role": "style",
"field_count": 1,
"editable_count": 0,
"editor_widget": "appearance preset selector",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"default_source": "Polished SaaS recipe tokens",
"summary": "Style fields use the appearance preset selector across 0/1 editable field."
},
{
"id": "content",
"label": "Content",
"field_role": "content",
"field_count": 5,
"editable_count": 5,
"editor_widget": "plain content field",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"default_source": "cloneable block recipe payload",
"summary": "Content fields use the plain content field across 5/5 editable fields."
}
],
"editor_field_roles": [
"copy",
"action",
"form",
"style",
"content"
],
"editor_editable_field_count": 15,
"state_readiness_count": 6,
"state_readiness_map": [
{
"id": "default",
"label": "Default",
"status": "covered",
"trigger": "Initial render with the cloneable recipe payload",
"visual_treatment": "Polished SaaS tokens with default documentation treatment",
"token_roles": [
"surface",
"panel",
"text",
"button"
],
"proof": "The Polished SaaS recipe renders a contract-safe primary state for tax-estimator.",
"summary": "Default state uses the recipe surface, text, and action tokens without one-off styling."
},
{
"id": "empty",
"label": "Empty",
"status": "covered",
"trigger": "Repeatable collections have zero items",
"visual_treatment": "Reserved panel space with fallback copy or placeholder media",
"token_roles": [
"panel",
"textMuted",
"badge",
"border"
],
"proof": "Repeatable fields are documented for add, remove, reorder, and item-level editing.",
"summary": "Empty-state guidance preserves layout rhythm instead of collapsing the block surface."
},
{
"id": "pending",
"label": "Pending",
"status": "covered",
"trigger": "Async assignment, embed load, or form submission is in flight",
"visual_treatment": "Neutral reserved frame with status copy and no layout shift",
"token_roles": [
"control",
"textMuted",
"progressTrack",
"border"
],
"proof": "Async-capable props are mapped through controls, events, or provider placeholders.",
"summary": "Pending state keeps dimensions stable while using muted control/status tokens."
},
{
"id": "active",
"label": "Active",
"status": "covered",
"trigger": "Selected action, active link, checked input, or open disclosure",
"visual_treatment": "Signal/uplink emphasis with visible selected-state chips",
"token_roles": [
"signal",
"uplink",
"button",
"badge"
],
"proof": "1 action surface and 2 control surfaces are mapped for selected-state review.",
"summary": "Active state is represented with recipe accent tokens and visible state labels."
},
{
"id": "invalid",
"label": "Invalid",
"status": "covered",
"trigger": "Required input, option, or submitted value is invalid",
"visual_treatment": "Warning/danger status treatment while preserving the block frame",
"token_roles": [
"warning",
"danger",
"border",
"text"
],
"proof": "Form controls preserve labels, required state, options, and submission metadata.",
"summary": "Invalid state guidance favors explicit status evidence over ambiguous visual collapse."
},
{
"id": "disabled",
"label": "Disabled",
"status": "covered",
"trigger": "Unavailable action or temporarily disabled control",
"visual_treatment": "Muted affordance with preserved label, spacing, and hit-area rhythm",
"token_roles": [
"control",
"textMuted",
"border",
"panel"
],
"proof": "Interactive maps preserve labels and control roles so disabled states can stay understandable.",
"summary": "Disabled state keeps the block readable and spatially stable when interaction is unavailable."
}
],
"state_readiness_states": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"state_readiness_statuses": [
"covered",
"covered",
"covered",
"covered",
"covered",
"covered"
],
"anatomy_region_count": 5,
"anatomy_map": [
{
"id": "surface",
"label": "Surface",
"region_role": "outer layout and background",
"field_paths": [
"appearance"
],
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"region_role": "headings, body copy, labels, and supporting text",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"token_roles": [
"text",
"textMuted"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"region_role": "CTA, link, event, and navigation affordances",
"field_paths": [
"connect_cta"
],
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"region_role": "inputs, choices, form fields, and operator controls",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value",
"inputs[0]",
"inputs[1]"
],
"token_roles": [
"control",
"controlText",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"region_role": "status, validation, selected, loading, and disabled evidence",
"field_paths": [],
"token_roles": [
"badge",
"badgeText",
"signal"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"anatomy_regions": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"anatomy_token_roles": [
"background",
"badge",
"badgeText",
"border",
"button",
"buttonText",
"control",
"controlText",
"panel",
"panelElevated",
"signal",
"text",
"textMuted",
"uplink"
],
"action_count": 1,
"action_map": [
{
"path": "connect_cta",
"label": "Request review",
"action_type": "primary",
"href": "#block-preview",
"event_name": null,
"summary": "Request review is a primary action linking to #block-preview."
}
],
"control_count": 2,
"control_map": [
{
"path": "inputs[0]",
"label": "Filing or project size",
"control_type": "number",
"required": false,
"option_count": null,
"summary": "Filing or project size is a number control."
},
{
"path": "inputs[1]",
"label": "Timing",
"control_type": "select",
"required": false,
"option_count": 2,
"summary": "Timing is a select control with 2 options."
}
],
"style_token_count": 15,
"style_token_map": [
{
"role": "background",
"label": "Page background",
"value": "#f7fbff",
"token_type": "color",
"summary": "Page background uses the background recipe token."
},
{
"role": "panel",
"label": "Panel surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Panel surface uses the panel recipe token."
},
{
"role": "panelElevated",
"label": "Elevated surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Elevated surface uses the panelElevated recipe token."
},
{
"role": "text",
"label": "Primary text",
"value": "#142033",
"token_type": "color",
"summary": "Primary text uses the text recipe token."
},
{
"role": "textMuted",
"label": "Muted text",
"value": "#526174",
"token_type": "color",
"summary": "Muted text uses the textMuted recipe token."
},
{
"role": "signal",
"label": "Signal accent",
"value": "#166bff",
"token_type": "color",
"summary": "Signal accent uses the signal recipe token."
},
{
"role": "uplink",
"label": "Secondary accent",
"value": "#00a6a6",
"token_type": "color",
"summary": "Secondary accent uses the uplink recipe token."
},
{
"role": "border",
"label": "Border",
"value": "#d6dee8",
"token_type": "color",
"summary": "Border uses the border recipe token."
},
{
"role": "control",
"label": "Control surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Control surface uses the control recipe token."
},
{
"role": "controlText",
"label": "Control text",
"value": "#142033",
"token_type": "color",
"summary": "Control text uses the controlText recipe token."
},
{
"role": "button",
"label": "Button surface",
"value": "#166bff",
"token_type": "color",
"summary": "Button surface uses the button recipe token."
},
{
"role": "buttonText",
"label": "Button text",
"value": "#ffffff",
"token_type": "color",
"summary": "Button text uses the buttonText recipe token."
},
{
"role": "badge",
"label": "Badge surface",
"value": "#eef5ff",
"token_type": "color",
"summary": "Badge surface uses the badge recipe token."
},
{
"role": "badgeText",
"label": "Badge text",
"value": "#174ea6",
"token_type": "color",
"summary": "Badge text uses the badgeText recipe token."
},
{
"role": "fontFamily",
"label": "Font family",
"value": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
"token_type": "font",
"summary": "Font family comes from the active recipe theme tokens."
}
],
"style_token_roles": [
"background",
"panel",
"panelElevated",
"text",
"textMuted",
"signal",
"uplink",
"border",
"control",
"controlText",
"button",
"buttonText",
"badge",
"badgeText",
"fontFamily"
],
"contrast_check_count": 6,
"contrast_pass_count": 6,
"contrast_checks": [
{
"id": "text-on-background",
"label": "Text on background",
"foreground_role": "text",
"background_role": "background",
"foreground": "#142033",
"background": "#f7fbff",
"ratio": 15.73,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on background is AAA at 15.73:1 against a 4.5:1 requirement."
},
{
"id": "text-on-panel",
"label": "Text on panel",
"foreground_role": "text",
"background_role": "panel",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on panel is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "muted-text-on-panel",
"label": "Muted text on panel",
"foreground_role": "textMuted",
"background_role": "panel",
"foreground": "#526174",
"background": "#ffffff",
"ratio": 6.32,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Muted text on panel is AA at 6.32:1 against a 4.5:1 requirement."
},
{
"id": "button-text-on-button",
"label": "Button text on button",
"foreground_role": "buttonText",
"background_role": "button",
"foreground": "#ffffff",
"background": "#166bff",
"ratio": 4.58,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Button text on button is AA at 4.58:1 against a 4.5:1 requirement."
},
{
"id": "control-text-on-control",
"label": "Control text on control",
"foreground_role": "controlText",
"background_role": "control",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Control text on control is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "badge-text-on-badge",
"label": "Badge text on badge",
"foreground_role": "badgeText",
"background_role": "badge",
"foreground": "#174ea6",
"background": "#eef5ff",
"ratio": 7.15,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Badge text on badge is AAA at 7.15:1 against a 4.5:1 requirement."
}
],
"contrast_target": "AA",
"accessibility_standard": "WCAG_2_2_AA",
"accessibility_check_count": 5,
"accessibility_checks": [
{
"id": "semantic-structure",
"label": "Semantic structure",
"category": "semantics",
"status": "covered",
"required": true,
"proof": "runtime block sections, cards, lists, and headings",
"summary": "tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview."
},
{
"id": "keyboard-and-tap-targets",
"label": "Keyboard and tap targets",
"category": "keyboard",
"status": "covered",
"required": true,
"proof": "mapped actions/controls render as native focusable surfaces",
"summary": "Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances."
},
{
"id": "text-alternatives",
"label": "Text alternatives",
"category": "media",
"status": "covered",
"required": false,
"proof": "media slots collapse when unused",
"summary": "Recipes without media do not leave decorative media shells that need alt text."
},
{
"id": "control-labels",
"label": "Control labels",
"category": "forms",
"status": "covered",
"required": true,
"proof": "control map includes required field labels and option metadata",
"summary": "Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review."
},
{
"id": "status-and-motion",
"label": "Status and motion",
"category": "state",
"status": "covered",
"required": true,
"proof": "runtime evidence avoids hidden status-only content",
"summary": "Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present."
}
],
"responsive_behavior_count": 3,
"responsive_behavior_map": [
{
"id": "phone",
"label": "Phone",
"viewport_width": 390,
"layout_mode": "single-column stack",
"column_count": 1,
"spacing_density": "comfortable",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-phone",
"summary": "Polished SaaS stacks tax-estimator into one phone column with comfortable spacing and bounded content."
},
{
"id": "tablet",
"label": "Tablet",
"viewport_width": 768,
"layout_mode": "two-column adaptive grid",
"column_count": 2,
"spacing_density": "comfortable",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-tablet",
"summary": "Polished SaaS adapts tax-estimator to 2 tablet columns before expanding to the desktop layout."
},
{
"id": "desktop",
"label": "Desktop",
"viewport_width": 1366,
"layout_mode": "responsive composition grid",
"column_count": 2,
"spacing_density": "comfortable",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-desktop",
"summary": "Polished SaaS gives tax-estimator up to 2 desktop columns while preserving recipe spacing."
}
],
"responsive_viewports": [
"phone",
"tablet",
"desktop"
],
"responsive_proof": [
"npm run test:static:block-catalog all-blocks-phone",
"npm run test:static:block-catalog all-blocks-tablet",
"npm run test:static:block-catalog all-blocks-desktop"
],
"interactive_roles": [
"number",
"primary",
"select"
],
"recipe_alignment": {
"action_token": "button",
"control_token": "control",
"surface_token": "panel",
"text_token": "text",
"source": "theme recipe tokens"
}
},
"cloneable": true
}
}Media Ready
Polished SaaS Growthmedia
A brandable payload that includes placeholder media where the block can express imagery, previews, or visual proof.
Component anatomy
5 regionsMedia Ready anatomy
Surfaceouter layout and background
tax-estimator uses recipe surface tokens to keep the outer frame styled and composable.
background, panel, panelElevated, borderCopyheadings, body copy, labels, and supporting text
Copy fields map to primary and muted text roles so editors can change words without restyling the block.
text, textMutedActionsCTA, link, event, and navigation affordances
Action regions use recipe button and accent tokens while preserving href or event payloads.
button, buttonText, signal, uplinkControlsinputs, choices, form fields, and operator controls
Control regions keep labels, required state, and options aligned with recipe control tokens.
control, controlText, borderFeedbackstatus, validation, selected, loading, and disabled evidence
Feedback regions tie state-readiness evidence to visible recipe status treatments.
badge, badgeText, signalRecipe passport
mediumMedia Ready passport
Use when the tax-estimator story depends on replaceable imagery, embeds, logos, or visual proof.
Media Ready is a medium-complexity media-led recipe with 5 documented composition slots.
3 required regions, 2 optional regions.
Slots
Surface / 0/1Copy / 5/5Actions / 1/1Controls / 4/6Feedback / 0/0
Replacement guidance
- Keep Polished SaaS Growth recipe tokens as the source of visual styling for the surface, text, controls, and actions.
- No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.
- Verify each action keeps either a valid href or canonical event name plus an editor-visible label.
- Verify control labels, required state, choices, and submission metadata before publishing.
- The recipe does not require repeatable collection editing.
Publish checklist
- Validate tax-estimator against its block contract before publishing.
- 3 required anatomy regions remain present: surface, copy, feedback.
- 15/16 builder fields are CMS-editable or intentionally locked.
- Interactive labels, target size, href/event wiring, and disabled states have been reviewed.
- Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.
- Contrast checks meet the AA recipe target.
Recipe fit
6 axesMedia Ready recipe fit
Page contextpage / primary
funnelcontactservice-pageevent-promotion
tax-estimator is best composed into funnel, contact, service-page, and related pages.
4 page types mapped for tax-estimator.Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.Section rolelayout / primary
conversioncontentform-controls
tax-estimator can act as conversion, content, form-controls within a composed page.
5 anatomy regions produce 3 section roles.Place the block where its required anatomy regions have enough room before compressing it into dense page slots.Content modelcontent / supporting
copy-ledcta-ledinput-led
Media Ready composition passport is copy-led, cta-led, input-led for CMS composition.
15/16 fields are editable across 3 content models.Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.Interaction modelinteraction / primary
primary-linknumberselect
tax-estimator carries primary-link, number, select interaction affordances.
1 action surface and 2 control surfaces mapped.Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.Authoring fitauthoring / specialized
media-ledmedium-complexity6-high-care-replacements
tax-estimator uses media-led authoring with medium complexity.
16 default provenance items with 6 high-care replacements.Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.Responsive fitresponsive / primary
single-column stacktwo-column adaptive gridresponsive composition gridmin-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.
tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages.
3 responsive behavior maps cover phone, tablet, and desktop composition.Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.Visual polish
6/6Media Ready visual polish
Surface rhythmlayout
tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers.
image treatment uses spacious density and 18px radius base.background, panel, panelElevated, borderType hierarchytypography
Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text.
6/6 contrast checks pass the AA target.text, textMuted, badgeTextAction clarityinteraction
Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options.
1 action surface and 2 control surfaces mapped.button, buttonText, control, controlText, signal, uplinkMedia treatmentmedia
The recipe remains polished without requiring placeholder media or visual assets inside this block.
No media region is required for this recipe.panelElevated, border, textMutedState feedbackstate
Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning.
6 state-readiness entries include default, empty, pending, active, invalid, disabled.badge, badgeText, signalResponsive balanceresponsive
Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe.
single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.panel, border, controlDefault provenance
16 fieldsMedia Ready default provenance
collection-itemlocked-tokenrequires-action-targetrequires-control-optionssafe-to-edit
- Appearanceappearance
Keep visual styling aligned to Polished SaaS Growth recipe tokens unless the recipe itself changes.
Polished SaaS Growth recipe tokens - Titletitle
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Descriptiondescription
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Modemode
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Inputsinputs
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Labelinputs[].label
Preserve control labels, required state, choices, submission metadata, and validation copy.
cloneable block recipe payload - Inputs Item Typeinputs[].type
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Valueinputs[].value
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Unitinputs[].unit
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Outputsoutputs
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Outputs Item Labeloutputs[].label
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Valueoutputs[].value
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Descriptionoutputs[].description
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Assumptionsassumptions
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Connect Ctaconnect_cta
Keep the label paired with a valid href or canonical postEvent event name before publishing.
CMS route, URL, or canonical postEvent path - Disclaimerdisclaimer
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload
Edit bundles
5 bundlesMedia Ready edit bundles
Copy bundlerequired / repeatable-items
descriptioninputs[].labeloutputs[].descriptionoutputs[].labeltitle
Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.Action bundlerecommended / single-field
connect_cta
Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
CMS route, URL, or canonical postEvent pathKeep the label paired with a valid href or canonical postEvent event name before publishing.Control bundlerecommended / repeatable-items
inputsinputs[].typeinputs[].unitinputs[].value
Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish.
CMS form schema or tenant data-capture defaultsPreserve control labels, required state, choices, submission metadata, and validation copy.Style bundleguarded / guarded-system
appearance
Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
Polished SaaS Growth recipe tokensKeep visual styling aligned to Polished SaaS Growth recipe tokens unless the recipe itself changes.Content bundlerequired / repeatable-items
assumptionsdisclaimermodeoutputsoutputs[].value
Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.CMS composition
16 fieldsMedia Ready fields
actioncontentcopyformstyle
- Appearanceappearance
- Titletitle
- Descriptiondescription
- Modemode
- Inputsinputs
- Inputs Item Labelinputs[].label
- Inputs Item Typeinputs[].type
- Inputs Item Valueinputs[].value
- Inputs Item Unitinputs[].unit
- Outputsoutputs
- Outputs Item Labeloutputs[].label
- Outputs Item Valueoutputs[].value
- Outputs Item Descriptionoutputs[].description
- Assumptionsassumptions
- Connect Ctaconnect_cta
- Disclaimerdisclaimer
CMS editing
15/16 editableMedia Ready editor guidance
Copytext/rich-text editor
Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.
cloneable block recipe payloadActionlink or event action editor
Actions should resolve to a URL or event name with a human-readable label.
CMS route, URL, or canonical postEvent pathFormform schema and input editor
Form fields should preserve labels, required state, options, and submission metadata.
CMS form schema or tenant data-capture defaultsStyleappearance preset selector
Style fields should prefer recipe or appearance tokens over one-off inline values.
Polished SaaS Growth recipe tokensContentplain content field
Content should remain serializable JSON and preserve the documented block contract.
cloneable block recipe payloadDefault states
6 statesMedia Ready state readiness
DefaultInitial render with the cloneable recipe payload
Polished SaaS Growth tokens with image documentation treatment
The Polished SaaS Growth recipe renders a contract-safe primary state for tax-estimator.EmptyRepeatable collections have zero items
Reserved panel space with fallback copy or placeholder media
Repeatable fields are documented for add, remove, reorder, and item-level editing.PendingAsync assignment, embed load, or form submission is in flight
Neutral reserved frame with status copy and no layout shift
Async-capable props are mapped through controls, events, or provider placeholders.ActiveSelected action, active link, checked input, or open disclosure
Signal/uplink emphasis with visible selected-state chips
1 action surface and 2 control surfaces are mapped for selected-state review.InvalidRequired input, option, or submitted value is invalid
Warning/danger status treatment while preserving the block frame
Form controls preserve labels, required state, options, and submission metadata.DisabledUnavailable action or temporarily disabled control
Muted affordance with preserved label, spacing, and hit-area rhythm
Interactive maps preserve labels and control roles so disabled states can stay understandable.Controls and actions
3 surfacesMedia Ready actions and controls
primarynumberselect
Actions
- Request reviewconnect_cta
Controls
- Filing or project sizeinputs[0]
- Timinginputs[1]
Recipe styling
15 tokensMedia Ready style tokens
Page background#f7fbff
Panel surface#ffffff
Elevated surface#ffffff
Primary text#142033
Muted text#526174
Signal accent#166bff
Secondary accent#00a6a6
Border#d6dee8
Control surface#ffffff
Control text#142033
Button surface#166bff
Button text#ffffff
Badge surface#eef5ff
Badge text#174ea6
Font familyInter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
Readability
6/6Media Ready contrast checks
Text on background15.73:1 / AAA
Text on panel16.35:1 / AAA
Muted text on panel6.32:1 / AA
Button text on button4.58:1 / AA
Control text on control16.35:1 / AAA
Badge text on badge7.15:1 / AAA
Accessibility proof
WCAG 2.2 AAMedia Ready accessibility checks
Semantic structuresemantics / required
tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview.
runtime block sections, cards, lists, and headingsKeyboard and tap targetskeyboard / required
Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances.
mapped actions/controls render as native focusable surfacesText alternativesmedia / contextual
Recipes without media do not leave decorative media shells that need alt text.
media slots collapse when unusedControl labelsforms / required
Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review.
control map includes required field labels and option metadataStatus and motionstate / required
Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present.
runtime evidence avoids hidden status-only contentResponsive proof
3 viewportsMedia Ready responsive behavior
Phone390px / single-column stack
Polished SaaS Growth stacks tax-estimator into one phone column with spacious spacing and bounded content.
min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.Tablet768px / two-column adaptive grid
Polished SaaS Growth adapts tax-estimator to 2 tablet columns before expanding to the desktop layout.
tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.Desktop1366px / responsive composition grid
Polished SaaS Growth gives tax-estimator up to 2 desktop columns while preserving recipe spacing.
desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Structured payload
{
"id": "block-doc-tax-estimator-data-media-ready",
"block_type": "tax-estimator",
"props": {
"appearance": {
"preset": "bento"
},
"title": "Tax planning estimator",
"description": "A static estimator surface for inputs, outputs, assumptions, and review handoff.",
"mode": "tax",
"inputs": [
{
"label": "Filing or project size",
"type": "number",
"value": "2",
"unit": "units"
},
{
"label": "Timing",
"type": "select",
"value": "This quarter",
"options": [
"This quarter",
"Next quarter"
]
}
],
"outputs": [
{
"label": "Estimated range",
"value": "$1,200-$2,400",
"description": "Demo-only range based on local assumptions."
},
{
"label": "Review needed",
"value": "Human confirmation required",
"description": "Final numbers require provider review."
}
],
"assumptions": [
"Uses example content only",
"No submission or stored calculation is created"
],
"connect_cta": {
"text": "Request review",
"href": "#block-preview"
},
"disclaimer": "This estimator is informational and does not provide binding advice, pricing, or eligibility."
},
"block_order": 2,
"metadata": {
"composition_recipe": {
"id": "media-ready",
"intent": "media",
"label": "Media Ready",
"recipe": "polished-saas-growth",
"source": "block-explorer",
"quality_proof": [
"composition"
],
"composition_passport": {
"id": "media-ready",
"label": "Media Ready composition passport",
"intent": "media",
"recipe": "polished-saas-growth",
"authoring_mode": "media-led",
"complexity": "medium",
"fit": "Use when the tax-estimator story depends on replaceable imagery, embeds, logos, or visual proof.",
"required_regions": [
"surface",
"copy",
"feedback"
],
"optional_regions": [
"actions",
"controls"
],
"slots": [
{
"id": "surface",
"label": "Surface",
"required": true,
"field_count": 1,
"editable_count": 0,
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"required": true,
"field_count": 5,
"editable_count": 5,
"token_roles": [
"text",
"textMuted"
],
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"required": false,
"field_count": 1,
"editable_count": 1,
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"required": false,
"field_count": 6,
"editable_count": 4,
"token_roles": [
"control",
"controlText",
"border"
],
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"required": true,
"field_count": 0,
"editable_count": 0,
"token_roles": [
"badge",
"badgeText",
"signal"
],
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"builder_field_count": 16,
"editable_field_count": 15,
"action_count": 1,
"control_count": 2,
"replacement_guidance": [
"Keep Polished SaaS Growth recipe tokens as the source of visual styling for the surface, text, controls, and actions.",
"No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.",
"Verify each action keeps either a valid href or canonical event name plus an editor-visible label.",
"Verify control labels, required state, choices, and submission metadata before publishing.",
"The recipe does not require repeatable collection editing."
],
"publish_checklist": [
"Validate tax-estimator against its block contract before publishing.",
"3 required anatomy regions remain present: surface, copy, feedback.",
"15/16 builder fields are CMS-editable or intentionally locked.",
"Interactive labels, target size, href/event wiring, and disabled states have been reviewed.",
"Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.",
"Contrast checks meet the AA recipe target."
],
"agent_notes": [
"Prefer editing props fields described by the builder field map; metadata is evidence, not primary content.",
"Preserve recipe_alignment token roles unless the page theme or recipe changes intentionally.",
"Use the anatomy slots to compose or replace content without changing the block type."
],
"summary": "Media Ready is a medium-complexity media-led recipe with 5 documented composition slots."
},
"composition_passport_complexity": "medium",
"composition_passport_authoring_mode": "media-led",
"composition_passport_slots": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"composition_passport_check_count": 6,
"visual_polish_check_count": 6,
"visual_polish_pass_count": 6,
"visual_polish_checks": [
{
"id": "surface-rhythm",
"label": "Surface rhythm",
"axis": "layout",
"status": "ready",
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"evidence": "image treatment uses spacious density and 18px radius base.",
"summary": "tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers."
},
{
"id": "type-hierarchy",
"label": "Type hierarchy",
"axis": "typography",
"status": "ready",
"token_roles": [
"text",
"textMuted",
"badgeText"
],
"evidence": "6/6 contrast checks pass the AA target.",
"summary": "Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text."
},
{
"id": "action-clarity",
"label": "Action clarity",
"axis": "interaction",
"status": "ready",
"token_roles": [
"button",
"buttonText",
"control",
"controlText",
"signal",
"uplink"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"summary": "Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options."
},
{
"id": "media-treatment",
"label": "Media treatment",
"axis": "media",
"status": "ready",
"token_roles": [
"panelElevated",
"border",
"textMuted"
],
"evidence": "No media region is required for this recipe.",
"summary": "The recipe remains polished without requiring placeholder media or visual assets inside this block."
},
{
"id": "state-feedback",
"label": "State feedback",
"axis": "state",
"status": "ready",
"token_roles": [
"badge",
"badgeText",
"signal"
],
"evidence": "6 state-readiness entries include default, empty, pending, active, invalid, disabled.",
"summary": "Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning."
},
{
"id": "responsive-balance",
"label": "Responsive balance",
"axis": "responsive",
"status": "ready",
"token_roles": [
"panel",
"border",
"control"
],
"evidence": "single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.",
"summary": "Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe."
}
],
"visual_polish_axes": [
"layout",
"typography",
"interaction",
"media",
"state",
"responsive"
],
"default_provenance_count": 16,
"default_provenance_map": [
{
"path": "appearance",
"label": "Appearance",
"field_role": "style",
"value_type": "object",
"editable": false,
"repeated": false,
"default_source": "Polished SaaS Growth recipe tokens",
"replacement_policy": "locked-token",
"replacement_risk": "medium",
"guardrail": "Keep visual styling aligned to Polished SaaS Growth recipe tokens unless the recipe itself changes.",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"summary": "Appearance defaults from Polished SaaS Growth recipe tokens; replacement is medium risk with locked-token policy."
},
{
"path": "title",
"label": "Title",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Title defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "description",
"label": "Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Description defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "mode",
"label": "Mode",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Mode defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "inputs",
"label": "Inputs",
"field_role": "form",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Inputs Item Label defaults from cloneable block recipe payload; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Type defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Value defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Unit defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "outputs",
"label": "Outputs",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs Item Value defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "assumptions",
"label": "Assumptions",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Assumptions defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"field_role": "action",
"value_type": "object",
"editable": true,
"repeated": false,
"default_source": "CMS route, URL, or canonical postEvent path",
"replacement_policy": "requires-action-target",
"replacement_risk": "high",
"guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"summary": "Connect Cta defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Disclaimer defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
}
],
"default_replacement_policies": [
"collection-item",
"locked-token",
"requires-action-target",
"requires-control-options",
"safe-to-edit"
],
"default_replacement_risks": [
"high",
"low",
"medium"
],
"default_replacement_high_risk_count": 6,
"content_edit_bundle_count": 5,
"content_edit_bundles": [
{
"id": "copy",
"label": "Copy bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Preserve control labels, required state, choices, submission metadata, and validation copy.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"type hierarchy",
"mobile wrapping"
],
"summary": "Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "actions",
"label": "Action bundle",
"intent": "recommended",
"edit_mode": "single-field",
"field_paths": [
"connect_cta"
],
"default_sources": [
"CMS route, URL, or canonical postEvent path"
],
"guardrails": [
"Keep the label paired with a valid href or canonical postEvent event name before publishing."
],
"depends_on": [
"copy labels",
"href or event target",
"state readiness"
],
"summary": "Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "controls",
"label": "Control bundle",
"intent": "recommended",
"edit_mode": "repeatable-items",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value"
],
"default_sources": [
"CMS form schema or tenant data-capture defaults"
],
"guardrails": [
"Preserve control labels, required state, choices, submission metadata, and validation copy."
],
"depends_on": [
"field labels",
"required state",
"disabled state"
],
"summary": "Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "style",
"label": "Style bundle",
"intent": "guarded",
"edit_mode": "guarded-system",
"field_paths": [
"appearance"
],
"default_sources": [
"Polished SaaS Growth recipe tokens"
],
"guardrails": [
"Keep visual styling aligned to Polished SaaS Growth recipe tokens unless the recipe itself changes."
],
"depends_on": [
"theme recipe tokens",
"contrast proof"
],
"summary": "Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "content",
"label": "Content bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"assumptions",
"disclaimer",
"mode",
"outputs",
"outputs[].value"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"contract-safe JSON"
],
"summary": "Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
}
],
"content_edit_bundle_ids": [
"copy",
"actions",
"controls",
"style",
"content"
],
"content_edit_bundle_modes": [
"guarded-system",
"repeatable-items",
"single-field"
],
"content_edit_bundle_required_count": 2,
"content_edit_bundle_guarded_count": 1,
"recipe_compatibility_count": 6,
"recipe_compatibility_map": [
{
"id": "page-context",
"label": "Page context",
"axis": "page",
"fit": "primary",
"values": [
"funnel",
"contact",
"service-page",
"event-promotion"
],
"evidence": "4 page types mapped for tax-estimator.",
"guardrail": "Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.",
"summary": "tax-estimator is best composed into funnel, contact, service-page, and related pages."
},
{
"id": "section-role",
"label": "Section role",
"axis": "layout",
"fit": "primary",
"values": [
"conversion",
"content",
"form-controls"
],
"evidence": "5 anatomy regions produce 3 section roles.",
"guardrail": "Place the block where its required anatomy regions have enough room before compressing it into dense page slots.",
"summary": "tax-estimator can act as conversion, content, form-controls within a composed page."
},
{
"id": "content-model",
"label": "Content model",
"axis": "content",
"fit": "supporting",
"values": [
"copy-led",
"cta-led",
"input-led"
],
"evidence": "15/16 fields are editable across 3 content models.",
"guardrail": "Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.",
"summary": "Media Ready composition passport is copy-led, cta-led, input-led for CMS composition."
},
{
"id": "interaction-model",
"label": "Interaction model",
"axis": "interaction",
"fit": "primary",
"values": [
"primary-link",
"number",
"select"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"guardrail": "Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.",
"summary": "tax-estimator carries primary-link, number, select interaction affordances."
},
{
"id": "authoring-fit",
"label": "Authoring fit",
"axis": "authoring",
"fit": "specialized",
"values": [
"media-led",
"medium-complexity",
"6-high-care-replacements"
],
"evidence": "16 default provenance items with 6 high-care replacements.",
"guardrail": "Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.",
"summary": "tax-estimator uses media-led authoring with medium complexity."
},
{
"id": "responsive-fit",
"label": "Responsive fit",
"axis": "responsive",
"fit": "primary",
"values": [
"single-column stack",
"two-column adaptive grid",
"responsive composition grid",
"min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke."
],
"evidence": "3 responsive behavior maps cover phone, tablet, and desktop composition.",
"guardrail": "Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.",
"summary": "tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages."
}
],
"recipe_compatibility_axes": [
"page",
"layout",
"content",
"interaction",
"authoring",
"responsive"
],
"recipe_compatibility_page_types": [
"funnel",
"contact",
"service-page",
"event-promotion"
],
"recipe_compatibility_section_roles": [
"conversion",
"content",
"form-controls"
],
"recipe_compatibility_fits": [
"primary",
"specialized",
"supporting"
],
"builder_field_count": 16,
"builder_field_map": [
{
"path": "appearance",
"label": "Appearance",
"value_type": "object",
"role": "style",
"editable": false,
"repeated": false,
"summary": "Appearance is a object field used for style."
},
{
"path": "title",
"label": "Title",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Title is a string field used for copy."
},
{
"path": "description",
"label": "Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Description is a string field used for copy."
},
{
"path": "mode",
"label": "Mode",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Mode is a string field used for content."
},
{
"path": "inputs",
"label": "Inputs",
"value_type": "array",
"role": "form",
"editable": true,
"repeated": false,
"summary": "Inputs is a array field used for form."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Inputs Item Label is a string collection field used for copy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Type is a string collection field used for form."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Value is a string collection field used for form."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Unit is a string collection field used for form."
},
{
"path": "outputs",
"label": "Outputs",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Outputs is a array field used for content."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Label is a string collection field used for copy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": true,
"summary": "Outputs Item Value is a string collection field used for content."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Description is a string collection field used for copy."
},
{
"path": "assumptions",
"label": "Assumptions",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Assumptions is a array field used for content."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"value_type": "object",
"role": "action",
"editable": true,
"repeated": false,
"summary": "Connect Cta is a object field used for action."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Disclaimer is a string field used for content."
}
],
"editor_guidance_count": 5,
"editor_guidance_map": [
{
"id": "copy",
"label": "Copy",
"field_role": "copy",
"field_count": 5,
"editable_count": 5,
"editor_widget": "text/rich-text editor",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"default_source": "cloneable block recipe payload",
"summary": "Copy fields use the text/rich-text editor across 5/5 editable fields."
},
{
"id": "action",
"label": "Action",
"field_role": "action",
"field_count": 1,
"editable_count": 1,
"editor_widget": "link or event action editor",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"default_source": "CMS route, URL, or canonical postEvent path",
"summary": "Action fields use the link or event action editor across 1/1 editable field."
},
{
"id": "form",
"label": "Form",
"field_role": "form",
"field_count": 4,
"editable_count": 4,
"editor_widget": "form schema and input editor",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"default_source": "CMS form schema or tenant data-capture defaults",
"summary": "Form fields use the form schema and input editor across 4/4 editable fields."
},
{
"id": "style",
"label": "Style",
"field_role": "style",
"field_count": 1,
"editable_count": 0,
"editor_widget": "appearance preset selector",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"default_source": "Polished SaaS Growth recipe tokens",
"summary": "Style fields use the appearance preset selector across 0/1 editable field."
},
{
"id": "content",
"label": "Content",
"field_role": "content",
"field_count": 5,
"editable_count": 5,
"editor_widget": "plain content field",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"default_source": "cloneable block recipe payload",
"summary": "Content fields use the plain content field across 5/5 editable fields."
}
],
"editor_field_roles": [
"copy",
"action",
"form",
"style",
"content"
],
"editor_editable_field_count": 15,
"state_readiness_count": 6,
"state_readiness_map": [
{
"id": "default",
"label": "Default",
"status": "covered",
"trigger": "Initial render with the cloneable recipe payload",
"visual_treatment": "Polished SaaS Growth tokens with image documentation treatment",
"token_roles": [
"surface",
"panel",
"text",
"button"
],
"proof": "The Polished SaaS Growth recipe renders a contract-safe primary state for tax-estimator.",
"summary": "Default state uses the recipe surface, text, and action tokens without one-off styling."
},
{
"id": "empty",
"label": "Empty",
"status": "covered",
"trigger": "Repeatable collections have zero items",
"visual_treatment": "Reserved panel space with fallback copy or placeholder media",
"token_roles": [
"panel",
"textMuted",
"badge",
"border"
],
"proof": "Repeatable fields are documented for add, remove, reorder, and item-level editing.",
"summary": "Empty-state guidance preserves layout rhythm instead of collapsing the block surface."
},
{
"id": "pending",
"label": "Pending",
"status": "covered",
"trigger": "Async assignment, embed load, or form submission is in flight",
"visual_treatment": "Neutral reserved frame with status copy and no layout shift",
"token_roles": [
"control",
"textMuted",
"progressTrack",
"border"
],
"proof": "Async-capable props are mapped through controls, events, or provider placeholders.",
"summary": "Pending state keeps dimensions stable while using muted control/status tokens."
},
{
"id": "active",
"label": "Active",
"status": "covered",
"trigger": "Selected action, active link, checked input, or open disclosure",
"visual_treatment": "Signal/uplink emphasis with visible selected-state chips",
"token_roles": [
"signal",
"uplink",
"button",
"badge"
],
"proof": "1 action surface and 2 control surfaces are mapped for selected-state review.",
"summary": "Active state is represented with recipe accent tokens and visible state labels."
},
{
"id": "invalid",
"label": "Invalid",
"status": "covered",
"trigger": "Required input, option, or submitted value is invalid",
"visual_treatment": "Warning/danger status treatment while preserving the block frame",
"token_roles": [
"warning",
"danger",
"border",
"text"
],
"proof": "Form controls preserve labels, required state, options, and submission metadata.",
"summary": "Invalid state guidance favors explicit status evidence over ambiguous visual collapse."
},
{
"id": "disabled",
"label": "Disabled",
"status": "covered",
"trigger": "Unavailable action or temporarily disabled control",
"visual_treatment": "Muted affordance with preserved label, spacing, and hit-area rhythm",
"token_roles": [
"control",
"textMuted",
"border",
"panel"
],
"proof": "Interactive maps preserve labels and control roles so disabled states can stay understandable.",
"summary": "Disabled state keeps the block readable and spatially stable when interaction is unavailable."
}
],
"state_readiness_states": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"state_readiness_statuses": [
"covered",
"covered",
"covered",
"covered",
"covered",
"covered"
],
"anatomy_region_count": 5,
"anatomy_map": [
{
"id": "surface",
"label": "Surface",
"region_role": "outer layout and background",
"field_paths": [
"appearance"
],
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"region_role": "headings, body copy, labels, and supporting text",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"token_roles": [
"text",
"textMuted"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"region_role": "CTA, link, event, and navigation affordances",
"field_paths": [
"connect_cta"
],
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"region_role": "inputs, choices, form fields, and operator controls",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value",
"inputs[0]",
"inputs[1]"
],
"token_roles": [
"control",
"controlText",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"region_role": "status, validation, selected, loading, and disabled evidence",
"field_paths": [],
"token_roles": [
"badge",
"badgeText",
"signal"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"anatomy_regions": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"anatomy_token_roles": [
"background",
"badge",
"badgeText",
"border",
"button",
"buttonText",
"control",
"controlText",
"panel",
"panelElevated",
"signal",
"text",
"textMuted",
"uplink"
],
"action_count": 1,
"action_map": [
{
"path": "connect_cta",
"label": "Request review",
"action_type": "primary",
"href": "#block-preview",
"event_name": null,
"summary": "Request review is a primary action linking to #block-preview."
}
],
"control_count": 2,
"control_map": [
{
"path": "inputs[0]",
"label": "Filing or project size",
"control_type": "number",
"required": false,
"option_count": null,
"summary": "Filing or project size is a number control."
},
{
"path": "inputs[1]",
"label": "Timing",
"control_type": "select",
"required": false,
"option_count": 2,
"summary": "Timing is a select control with 2 options."
}
],
"style_token_count": 15,
"style_token_map": [
{
"role": "background",
"label": "Page background",
"value": "#f7fbff",
"token_type": "color",
"summary": "Page background uses the background recipe token."
},
{
"role": "panel",
"label": "Panel surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Panel surface uses the panel recipe token."
},
{
"role": "panelElevated",
"label": "Elevated surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Elevated surface uses the panelElevated recipe token."
},
{
"role": "text",
"label": "Primary text",
"value": "#142033",
"token_type": "color",
"summary": "Primary text uses the text recipe token."
},
{
"role": "textMuted",
"label": "Muted text",
"value": "#526174",
"token_type": "color",
"summary": "Muted text uses the textMuted recipe token."
},
{
"role": "signal",
"label": "Signal accent",
"value": "#166bff",
"token_type": "color",
"summary": "Signal accent uses the signal recipe token."
},
{
"role": "uplink",
"label": "Secondary accent",
"value": "#00a6a6",
"token_type": "color",
"summary": "Secondary accent uses the uplink recipe token."
},
{
"role": "border",
"label": "Border",
"value": "#d6dee8",
"token_type": "color",
"summary": "Border uses the border recipe token."
},
{
"role": "control",
"label": "Control surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Control surface uses the control recipe token."
},
{
"role": "controlText",
"label": "Control text",
"value": "#142033",
"token_type": "color",
"summary": "Control text uses the controlText recipe token."
},
{
"role": "button",
"label": "Button surface",
"value": "#166bff",
"token_type": "color",
"summary": "Button surface uses the button recipe token."
},
{
"role": "buttonText",
"label": "Button text",
"value": "#ffffff",
"token_type": "color",
"summary": "Button text uses the buttonText recipe token."
},
{
"role": "badge",
"label": "Badge surface",
"value": "#eef5ff",
"token_type": "color",
"summary": "Badge surface uses the badge recipe token."
},
{
"role": "badgeText",
"label": "Badge text",
"value": "#174ea6",
"token_type": "color",
"summary": "Badge text uses the badgeText recipe token."
},
{
"role": "fontFamily",
"label": "Font family",
"value": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
"token_type": "font",
"summary": "Font family comes from the active recipe theme tokens."
}
],
"style_token_roles": [
"background",
"panel",
"panelElevated",
"text",
"textMuted",
"signal",
"uplink",
"border",
"control",
"controlText",
"button",
"buttonText",
"badge",
"badgeText",
"fontFamily"
],
"contrast_check_count": 6,
"contrast_pass_count": 6,
"contrast_checks": [
{
"id": "text-on-background",
"label": "Text on background",
"foreground_role": "text",
"background_role": "background",
"foreground": "#142033",
"background": "#f7fbff",
"ratio": 15.73,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on background is AAA at 15.73:1 against a 4.5:1 requirement."
},
{
"id": "text-on-panel",
"label": "Text on panel",
"foreground_role": "text",
"background_role": "panel",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on panel is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "muted-text-on-panel",
"label": "Muted text on panel",
"foreground_role": "textMuted",
"background_role": "panel",
"foreground": "#526174",
"background": "#ffffff",
"ratio": 6.32,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Muted text on panel is AA at 6.32:1 against a 4.5:1 requirement."
},
{
"id": "button-text-on-button",
"label": "Button text on button",
"foreground_role": "buttonText",
"background_role": "button",
"foreground": "#ffffff",
"background": "#166bff",
"ratio": 4.58,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Button text on button is AA at 4.58:1 against a 4.5:1 requirement."
},
{
"id": "control-text-on-control",
"label": "Control text on control",
"foreground_role": "controlText",
"background_role": "control",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Control text on control is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "badge-text-on-badge",
"label": "Badge text on badge",
"foreground_role": "badgeText",
"background_role": "badge",
"foreground": "#174ea6",
"background": "#eef5ff",
"ratio": 7.15,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Badge text on badge is AAA at 7.15:1 against a 4.5:1 requirement."
}
],
"contrast_target": "AA",
"accessibility_standard": "WCAG_2_2_AA",
"accessibility_check_count": 5,
"accessibility_checks": [
{
"id": "semantic-structure",
"label": "Semantic structure",
"category": "semantics",
"status": "covered",
"required": true,
"proof": "runtime block sections, cards, lists, and headings",
"summary": "tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview."
},
{
"id": "keyboard-and-tap-targets",
"label": "Keyboard and tap targets",
"category": "keyboard",
"status": "covered",
"required": true,
"proof": "mapped actions/controls render as native focusable surfaces",
"summary": "Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances."
},
{
"id": "text-alternatives",
"label": "Text alternatives",
"category": "media",
"status": "covered",
"required": false,
"proof": "media slots collapse when unused",
"summary": "Recipes without media do not leave decorative media shells that need alt text."
},
{
"id": "control-labels",
"label": "Control labels",
"category": "forms",
"status": "covered",
"required": true,
"proof": "control map includes required field labels and option metadata",
"summary": "Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review."
},
{
"id": "status-and-motion",
"label": "Status and motion",
"category": "state",
"status": "covered",
"required": true,
"proof": "runtime evidence avoids hidden status-only content",
"summary": "Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present."
}
],
"responsive_behavior_count": 3,
"responsive_behavior_map": [
{
"id": "phone",
"label": "Phone",
"viewport_width": 390,
"layout_mode": "single-column stack",
"column_count": 1,
"spacing_density": "spacious",
"media_policy": "Inline media uses full-width phone framing, tablet-friendly aspect ratios, and stable desktop constraints.",
"overflow_policy": "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-phone",
"summary": "Polished SaaS Growth stacks tax-estimator into one phone column with spacious spacing and bounded content."
},
{
"id": "tablet",
"label": "Tablet",
"viewport_width": 768,
"layout_mode": "two-column adaptive grid",
"column_count": 2,
"spacing_density": "spacious",
"media_policy": "Inline media uses full-width phone framing, tablet-friendly aspect ratios, and stable desktop constraints.",
"overflow_policy": "tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-tablet",
"summary": "Polished SaaS Growth adapts tax-estimator to 2 tablet columns before expanding to the desktop layout."
},
{
"id": "desktop",
"label": "Desktop",
"viewport_width": 1366,
"layout_mode": "responsive composition grid",
"column_count": 2,
"spacing_density": "spacious",
"media_policy": "Inline media uses full-width phone framing, tablet-friendly aspect ratios, and stable desktop constraints.",
"overflow_policy": "desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-desktop",
"summary": "Polished SaaS Growth gives tax-estimator up to 2 desktop columns while preserving recipe spacing."
}
],
"responsive_viewports": [
"phone",
"tablet",
"desktop"
],
"responsive_proof": [
"npm run test:static:block-catalog all-blocks-phone",
"npm run test:static:block-catalog all-blocks-tablet",
"npm run test:static:block-catalog all-blocks-desktop"
],
"interactive_roles": [
"number",
"primary",
"select"
],
"recipe_alignment": {
"action_token": "button",
"control_token": "control",
"surface_token": "panel",
"text_token": "text",
"source": "theme recipe tokens"
}
},
"cloneable": true
}
}Compact Ops
Compact Opsoperator
A dense operator-friendly payload for dashboards, catalogs, forms, and internal review surfaces.
Component anatomy
5 regionsCompact Ops anatomy
Surfaceouter layout and background
tax-estimator uses recipe surface tokens to keep the outer frame styled and composable.
background, panel, panelElevated, borderCopyheadings, body copy, labels, and supporting text
Copy fields map to primary and muted text roles so editors can change words without restyling the block.
text, textMutedActionsCTA, link, event, and navigation affordances
Action regions use recipe button and accent tokens while preserving href or event payloads.
button, buttonText, signal, uplinkControlsinputs, choices, form fields, and operator controls
Control regions keep labels, required state, and options aligned with recipe control tokens.
control, controlText, borderFeedbackstatus, validation, selected, loading, and disabled evidence
Feedback regions tie state-readiness evidence to visible recipe status treatments.
badge, badgeText, signalRecipe passport
mediumCompact Ops passport
Use when editors need denser tax-estimator controls, diagnostics, or internal review context.
Compact Ops is a medium-complexity operator-review recipe with 5 documented composition slots.
3 required regions, 2 optional regions.
Slots
Surface / 0/1Copy / 5/5Actions / 1/1Controls / 4/6Feedback / 0/0
Replacement guidance
- Keep Compact Ops recipe tokens as the source of visual styling for the surface, text, controls, and actions.
- No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.
- Verify each action keeps either a valid href or canonical event name plus an editor-visible label.
- Verify control labels, required state, choices, and submission metadata before publishing.
- The recipe does not require repeatable collection editing.
Publish checklist
- Validate tax-estimator against its block contract before publishing.
- 3 required anatomy regions remain present: surface, copy, feedback.
- 15/16 builder fields are CMS-editable or intentionally locked.
- Interactive labels, target size, href/event wiring, and disabled states have been reviewed.
- Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.
- Contrast checks meet the AA recipe target.
Recipe fit
6 axesCompact Ops recipe fit
Page contextpage / primary
funnelcontactservice-pagelisting
tax-estimator is best composed into funnel, contact, service-page, and related pages.
4 page types mapped for tax-estimator.Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.Section rolelayout / primary
conversioncontentform-controls
tax-estimator can act as conversion, content, form-controls within a composed page.
5 anatomy regions produce 3 section roles.Place the block where its required anatomy regions have enough room before compressing it into dense page slots.Content modelcontent / supporting
copy-ledcta-ledinput-led
Compact Ops composition passport is copy-led, cta-led, input-led for CMS composition.
15/16 fields are editable across 3 content models.Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.Interaction modelinteraction / primary
primary-linknumberselect
tax-estimator carries primary-link, number, select interaction affordances.
1 action surface and 2 control surfaces mapped.Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.Authoring fitauthoring / specialized
operator-reviewmedium-complexity6-high-care-replacements
tax-estimator uses operator-review authoring with medium complexity.
16 default provenance items with 6 high-care replacements.Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.Responsive fitresponsive / primary
single-column stacktwo-column adaptive gridresponsive composition gridmin-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.
tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages.
3 responsive behavior maps cover phone, tablet, and desktop composition.Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.Visual polish
6/6Compact Ops visual polish
Surface rhythmlayout
tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers.
dense treatment uses compact density and 8px radius base.background, panel, panelElevated, borderType hierarchytypography
Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text.
6/6 contrast checks pass the AA target.text, textMuted, badgeTextAction clarityinteraction
Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options.
1 action surface and 2 control surfaces mapped.button, buttonText, control, controlText, signal, uplinkMedia treatmentmedia
The recipe remains polished without requiring placeholder media or visual assets inside this block.
No media region is required for this recipe.panelElevated, border, textMutedState feedbackstate
Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning.
6 state-readiness entries include default, empty, pending, active, invalid, disabled.badge, badgeText, signalResponsive balanceresponsive
Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe.
single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.panel, border, controlDefault provenance
16 fieldsCompact Ops default provenance
collection-itemlocked-tokenrequires-action-targetrequires-control-optionssafe-to-edit
- Appearanceappearance
Keep visual styling aligned to Compact Ops recipe tokens unless the recipe itself changes.
Compact Ops recipe tokens - Titletitle
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Descriptiondescription
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Modemode
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Inputsinputs
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Labelinputs[].label
Preserve control labels, required state, choices, submission metadata, and validation copy.
cloneable block recipe payload - Inputs Item Typeinputs[].type
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Valueinputs[].value
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Unitinputs[].unit
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Outputsoutputs
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Outputs Item Labeloutputs[].label
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Valueoutputs[].value
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Descriptionoutputs[].description
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Assumptionsassumptions
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Connect Ctaconnect_cta
Keep the label paired with a valid href or canonical postEvent event name before publishing.
CMS route, URL, or canonical postEvent path - Disclaimerdisclaimer
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload
Edit bundles
5 bundlesCompact Ops edit bundles
Copy bundlerequired / repeatable-items
descriptioninputs[].labeloutputs[].descriptionoutputs[].labeltitle
Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.Action bundlerecommended / single-field
connect_cta
Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
CMS route, URL, or canonical postEvent pathKeep the label paired with a valid href or canonical postEvent event name before publishing.Control bundlerecommended / repeatable-items
inputsinputs[].typeinputs[].unitinputs[].value
Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish.
CMS form schema or tenant data-capture defaultsPreserve control labels, required state, choices, submission metadata, and validation copy.Style bundleguarded / guarded-system
appearance
Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
Compact Ops recipe tokensKeep visual styling aligned to Compact Ops recipe tokens unless the recipe itself changes.Content bundlerequired / repeatable-items
assumptionsdisclaimermodeoutputsoutputs[].value
Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.CMS composition
16 fieldsCompact Ops fields
actioncontentcopyformstyle
- Appearanceappearance
- Titletitle
- Descriptiondescription
- Modemode
- Inputsinputs
- Inputs Item Labelinputs[].label
- Inputs Item Typeinputs[].type
- Inputs Item Valueinputs[].value
- Inputs Item Unitinputs[].unit
- Outputsoutputs
- Outputs Item Labeloutputs[].label
- Outputs Item Valueoutputs[].value
- Outputs Item Descriptionoutputs[].description
- Assumptionsassumptions
- Connect Ctaconnect_cta
- Disclaimerdisclaimer
CMS editing
15/16 editableCompact Ops editor guidance
Copytext/rich-text editor
Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.
cloneable block recipe payloadActionlink or event action editor
Actions should resolve to a URL or event name with a human-readable label.
CMS route, URL, or canonical postEvent pathFormform schema and input editor
Form fields should preserve labels, required state, options, and submission metadata.
CMS form schema or tenant data-capture defaultsStyleappearance preset selector
Style fields should prefer recipe or appearance tokens over one-off inline values.
Compact Ops recipe tokensContentplain content field
Content should remain serializable JSON and preserve the documented block contract.
cloneable block recipe payloadDefault states
6 statesCompact Ops state readiness
DefaultInitial render with the cloneable recipe payload
Compact Ops tokens with dense documentation treatment
The Compact Ops recipe renders a contract-safe primary state for tax-estimator.EmptyRepeatable collections have zero items
Reserved panel space with fallback copy or placeholder media
Repeatable fields are documented for add, remove, reorder, and item-level editing.PendingAsync assignment, embed load, or form submission is in flight
Neutral reserved frame with status copy and no layout shift
Async-capable props are mapped through controls, events, or provider placeholders.ActiveSelected action, active link, checked input, or open disclosure
Signal/uplink emphasis with visible selected-state chips
1 action surface and 2 control surfaces are mapped for selected-state review.InvalidRequired input, option, or submitted value is invalid
Warning/danger status treatment while preserving the block frame
Form controls preserve labels, required state, options, and submission metadata.DisabledUnavailable action or temporarily disabled control
Muted affordance with preserved label, spacing, and hit-area rhythm
Interactive maps preserve labels and control roles so disabled states can stay understandable.Controls and actions
3 surfacesCompact Ops actions and controls
primarynumberselect
Actions
- Request reviewconnect_cta
Controls
- Filing or project sizeinputs[0]
- Timinginputs[1]
Recipe styling
15 tokensCompact Ops style tokens
Page background#f7fbff
Panel surface#ffffff
Elevated surface#ffffff
Primary text#142033
Muted text#526174
Signal accent#166bff
Secondary accent#00a6a6
Border#d6dee8
Control surface#ffffff
Control text#142033
Button surface#166bff
Button text#ffffff
Badge surface#eef5ff
Badge text#174ea6
Font familyInter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
Readability
6/6Compact Ops contrast checks
Text on background15.73:1 / AAA
Text on panel16.35:1 / AAA
Muted text on panel6.32:1 / AA
Button text on button4.58:1 / AA
Control text on control16.35:1 / AAA
Badge text on badge7.15:1 / AAA
Accessibility proof
WCAG 2.2 AACompact Ops accessibility checks
Semantic structuresemantics / required
tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview.
runtime block sections, cards, lists, and headingsKeyboard and tap targetskeyboard / required
Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances.
mapped actions/controls render as native focusable surfacesText alternativesmedia / contextual
Recipes without media do not leave decorative media shells that need alt text.
media slots collapse when unusedControl labelsforms / required
Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review.
control map includes required field labels and option metadataStatus and motionstate / required
Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present.
runtime evidence avoids hidden status-only contentResponsive proof
3 viewportsCompact Ops responsive behavior
Phone390px / single-column stack
Compact Ops stacks tax-estimator into one phone column with compact spacing and bounded content.
min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.Tablet768px / two-column adaptive grid
Compact Ops adapts tax-estimator to 2 tablet columns before expanding to the desktop layout.
tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.Desktop1366px / responsive composition grid
Compact Ops gives tax-estimator up to 2 desktop columns while preserving recipe spacing.
desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Structured payload
{
"id": "block-doc-tax-estimator-data-compact-ops",
"block_type": "tax-estimator",
"props": {
"appearance": {
"preset": "dashboard"
},
"title": "Tax planning estimator",
"description": "A static estimator surface for inputs, outputs, assumptions, and review handoff.",
"mode": "tax",
"inputs": [
{
"label": "Filing or project size",
"type": "number",
"value": "2",
"unit": "units"
},
{
"label": "Timing",
"type": "select",
"value": "This quarter",
"options": [
"This quarter",
"Next quarter"
]
}
],
"outputs": [
{
"label": "Estimated range",
"value": "$1,200-$2,400",
"description": "Demo-only range based on local assumptions."
},
{
"label": "Review needed",
"value": "Human confirmation required",
"description": "Final numbers require provider review."
}
],
"assumptions": [
"Uses example content only",
"No submission or stored calculation is created"
],
"connect_cta": {
"text": "Request review",
"href": "#block-preview"
},
"disclaimer": "This estimator is informational and does not provide binding advice, pricing, or eligibility."
},
"block_order": 3,
"metadata": {
"composition_recipe": {
"id": "compact-ops",
"intent": "operator",
"label": "Compact Ops",
"recipe": "compact-ops",
"source": "block-explorer",
"quality_proof": [
"composition"
],
"composition_passport": {
"id": "compact-ops",
"label": "Compact Ops composition passport",
"intent": "operator",
"recipe": "compact-ops",
"authoring_mode": "operator-review",
"complexity": "medium",
"fit": "Use when editors need denser tax-estimator controls, diagnostics, or internal review context.",
"required_regions": [
"surface",
"copy",
"feedback"
],
"optional_regions": [
"actions",
"controls"
],
"slots": [
{
"id": "surface",
"label": "Surface",
"required": true,
"field_count": 1,
"editable_count": 0,
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"required": true,
"field_count": 5,
"editable_count": 5,
"token_roles": [
"text",
"textMuted"
],
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"required": false,
"field_count": 1,
"editable_count": 1,
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"required": false,
"field_count": 6,
"editable_count": 4,
"token_roles": [
"control",
"controlText",
"border"
],
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"required": true,
"field_count": 0,
"editable_count": 0,
"token_roles": [
"badge",
"badgeText",
"signal"
],
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"builder_field_count": 16,
"editable_field_count": 15,
"action_count": 1,
"control_count": 2,
"replacement_guidance": [
"Keep Compact Ops recipe tokens as the source of visual styling for the surface, text, controls, and actions.",
"No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.",
"Verify each action keeps either a valid href or canonical event name plus an editor-visible label.",
"Verify control labels, required state, choices, and submission metadata before publishing.",
"The recipe does not require repeatable collection editing."
],
"publish_checklist": [
"Validate tax-estimator against its block contract before publishing.",
"3 required anatomy regions remain present: surface, copy, feedback.",
"15/16 builder fields are CMS-editable or intentionally locked.",
"Interactive labels, target size, href/event wiring, and disabled states have been reviewed.",
"Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.",
"Contrast checks meet the AA recipe target."
],
"agent_notes": [
"Prefer editing props fields described by the builder field map; metadata is evidence, not primary content.",
"Preserve recipe_alignment token roles unless the page theme or recipe changes intentionally.",
"Use the anatomy slots to compose or replace content without changing the block type."
],
"summary": "Compact Ops is a medium-complexity operator-review recipe with 5 documented composition slots."
},
"composition_passport_complexity": "medium",
"composition_passport_authoring_mode": "operator-review",
"composition_passport_slots": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"composition_passport_check_count": 6,
"visual_polish_check_count": 6,
"visual_polish_pass_count": 6,
"visual_polish_checks": [
{
"id": "surface-rhythm",
"label": "Surface rhythm",
"axis": "layout",
"status": "ready",
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"evidence": "dense treatment uses compact density and 8px radius base.",
"summary": "tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers."
},
{
"id": "type-hierarchy",
"label": "Type hierarchy",
"axis": "typography",
"status": "ready",
"token_roles": [
"text",
"textMuted",
"badgeText"
],
"evidence": "6/6 contrast checks pass the AA target.",
"summary": "Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text."
},
{
"id": "action-clarity",
"label": "Action clarity",
"axis": "interaction",
"status": "ready",
"token_roles": [
"button",
"buttonText",
"control",
"controlText",
"signal",
"uplink"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"summary": "Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options."
},
{
"id": "media-treatment",
"label": "Media treatment",
"axis": "media",
"status": "ready",
"token_roles": [
"panelElevated",
"border",
"textMuted"
],
"evidence": "No media region is required for this recipe.",
"summary": "The recipe remains polished without requiring placeholder media or visual assets inside this block."
},
{
"id": "state-feedback",
"label": "State feedback",
"axis": "state",
"status": "ready",
"token_roles": [
"badge",
"badgeText",
"signal"
],
"evidence": "6 state-readiness entries include default, empty, pending, active, invalid, disabled.",
"summary": "Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning."
},
{
"id": "responsive-balance",
"label": "Responsive balance",
"axis": "responsive",
"status": "ready",
"token_roles": [
"panel",
"border",
"control"
],
"evidence": "single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.",
"summary": "Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe."
}
],
"visual_polish_axes": [
"layout",
"typography",
"interaction",
"media",
"state",
"responsive"
],
"default_provenance_count": 16,
"default_provenance_map": [
{
"path": "appearance",
"label": "Appearance",
"field_role": "style",
"value_type": "object",
"editable": false,
"repeated": false,
"default_source": "Compact Ops recipe tokens",
"replacement_policy": "locked-token",
"replacement_risk": "medium",
"guardrail": "Keep visual styling aligned to Compact Ops recipe tokens unless the recipe itself changes.",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"summary": "Appearance defaults from Compact Ops recipe tokens; replacement is medium risk with locked-token policy."
},
{
"path": "title",
"label": "Title",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Title defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "description",
"label": "Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Description defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "mode",
"label": "Mode",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Mode defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "inputs",
"label": "Inputs",
"field_role": "form",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Inputs Item Label defaults from cloneable block recipe payload; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Type defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Value defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Unit defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "outputs",
"label": "Outputs",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs Item Value defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "assumptions",
"label": "Assumptions",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Assumptions defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"field_role": "action",
"value_type": "object",
"editable": true,
"repeated": false,
"default_source": "CMS route, URL, or canonical postEvent path",
"replacement_policy": "requires-action-target",
"replacement_risk": "high",
"guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"summary": "Connect Cta defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Disclaimer defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
}
],
"default_replacement_policies": [
"collection-item",
"locked-token",
"requires-action-target",
"requires-control-options",
"safe-to-edit"
],
"default_replacement_risks": [
"high",
"low",
"medium"
],
"default_replacement_high_risk_count": 6,
"content_edit_bundle_count": 5,
"content_edit_bundles": [
{
"id": "copy",
"label": "Copy bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Preserve control labels, required state, choices, submission metadata, and validation copy.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"type hierarchy",
"mobile wrapping"
],
"summary": "Copy bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "actions",
"label": "Action bundle",
"intent": "recommended",
"edit_mode": "single-field",
"field_paths": [
"connect_cta"
],
"default_sources": [
"CMS route, URL, or canonical postEvent path"
],
"guardrails": [
"Keep the label paired with a valid href or canonical postEvent event name before publishing."
],
"depends_on": [
"copy labels",
"href or event target",
"state readiness"
],
"summary": "Action bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "controls",
"label": "Control bundle",
"intent": "recommended",
"edit_mode": "repeatable-items",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value"
],
"default_sources": [
"CMS form schema or tenant data-capture defaults"
],
"guardrails": [
"Preserve control labels, required state, choices, submission metadata, and validation copy."
],
"depends_on": [
"field labels",
"required state",
"disabled state"
],
"summary": "Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "style",
"label": "Style bundle",
"intent": "guarded",
"edit_mode": "guarded-system",
"field_paths": [
"appearance"
],
"default_sources": [
"Compact Ops recipe tokens"
],
"guardrails": [
"Keep visual styling aligned to Compact Ops recipe tokens unless the recipe itself changes."
],
"depends_on": [
"theme recipe tokens",
"contrast proof"
],
"summary": "Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "content",
"label": "Content bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"assumptions",
"disclaimer",
"mode",
"outputs",
"outputs[].value"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"contract-safe JSON"
],
"summary": "Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
}
],
"content_edit_bundle_ids": [
"copy",
"actions",
"controls",
"style",
"content"
],
"content_edit_bundle_modes": [
"guarded-system",
"repeatable-items",
"single-field"
],
"content_edit_bundle_required_count": 2,
"content_edit_bundle_guarded_count": 1,
"recipe_compatibility_count": 6,
"recipe_compatibility_map": [
{
"id": "page-context",
"label": "Page context",
"axis": "page",
"fit": "primary",
"values": [
"funnel",
"contact",
"service-page",
"listing"
],
"evidence": "4 page types mapped for tax-estimator.",
"guardrail": "Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.",
"summary": "tax-estimator is best composed into funnel, contact, service-page, and related pages."
},
{
"id": "section-role",
"label": "Section role",
"axis": "layout",
"fit": "primary",
"values": [
"conversion",
"content",
"form-controls"
],
"evidence": "5 anatomy regions produce 3 section roles.",
"guardrail": "Place the block where its required anatomy regions have enough room before compressing it into dense page slots.",
"summary": "tax-estimator can act as conversion, content, form-controls within a composed page."
},
{
"id": "content-model",
"label": "Content model",
"axis": "content",
"fit": "supporting",
"values": [
"copy-led",
"cta-led",
"input-led"
],
"evidence": "15/16 fields are editable across 3 content models.",
"guardrail": "Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.",
"summary": "Compact Ops composition passport is copy-led, cta-led, input-led for CMS composition."
},
{
"id": "interaction-model",
"label": "Interaction model",
"axis": "interaction",
"fit": "primary",
"values": [
"primary-link",
"number",
"select"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"guardrail": "Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.",
"summary": "tax-estimator carries primary-link, number, select interaction affordances."
},
{
"id": "authoring-fit",
"label": "Authoring fit",
"axis": "authoring",
"fit": "specialized",
"values": [
"operator-review",
"medium-complexity",
"6-high-care-replacements"
],
"evidence": "16 default provenance items with 6 high-care replacements.",
"guardrail": "Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.",
"summary": "tax-estimator uses operator-review authoring with medium complexity."
},
{
"id": "responsive-fit",
"label": "Responsive fit",
"axis": "responsive",
"fit": "primary",
"values": [
"single-column stack",
"two-column adaptive grid",
"responsive composition grid",
"min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke."
],
"evidence": "3 responsive behavior maps cover phone, tablet, and desktop composition.",
"guardrail": "Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.",
"summary": "tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages."
}
],
"recipe_compatibility_axes": [
"page",
"layout",
"content",
"interaction",
"authoring",
"responsive"
],
"recipe_compatibility_page_types": [
"funnel",
"contact",
"service-page",
"listing"
],
"recipe_compatibility_section_roles": [
"conversion",
"content",
"form-controls"
],
"recipe_compatibility_fits": [
"primary",
"specialized",
"supporting"
],
"builder_field_count": 16,
"builder_field_map": [
{
"path": "appearance",
"label": "Appearance",
"value_type": "object",
"role": "style",
"editable": false,
"repeated": false,
"summary": "Appearance is a object field used for style."
},
{
"path": "title",
"label": "Title",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Title is a string field used for copy."
},
{
"path": "description",
"label": "Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Description is a string field used for copy."
},
{
"path": "mode",
"label": "Mode",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Mode is a string field used for content."
},
{
"path": "inputs",
"label": "Inputs",
"value_type": "array",
"role": "form",
"editable": true,
"repeated": false,
"summary": "Inputs is a array field used for form."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Inputs Item Label is a string collection field used for copy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Type is a string collection field used for form."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Value is a string collection field used for form."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Unit is a string collection field used for form."
},
{
"path": "outputs",
"label": "Outputs",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Outputs is a array field used for content."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Label is a string collection field used for copy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": true,
"summary": "Outputs Item Value is a string collection field used for content."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Description is a string collection field used for copy."
},
{
"path": "assumptions",
"label": "Assumptions",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Assumptions is a array field used for content."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"value_type": "object",
"role": "action",
"editable": true,
"repeated": false,
"summary": "Connect Cta is a object field used for action."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Disclaimer is a string field used for content."
}
],
"editor_guidance_count": 5,
"editor_guidance_map": [
{
"id": "copy",
"label": "Copy",
"field_role": "copy",
"field_count": 5,
"editable_count": 5,
"editor_widget": "text/rich-text editor",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"default_source": "cloneable block recipe payload",
"summary": "Copy fields use the text/rich-text editor across 5/5 editable fields."
},
{
"id": "action",
"label": "Action",
"field_role": "action",
"field_count": 1,
"editable_count": 1,
"editor_widget": "link or event action editor",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"default_source": "CMS route, URL, or canonical postEvent path",
"summary": "Action fields use the link or event action editor across 1/1 editable field."
},
{
"id": "form",
"label": "Form",
"field_role": "form",
"field_count": 4,
"editable_count": 4,
"editor_widget": "form schema and input editor",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"default_source": "CMS form schema or tenant data-capture defaults",
"summary": "Form fields use the form schema and input editor across 4/4 editable fields."
},
{
"id": "style",
"label": "Style",
"field_role": "style",
"field_count": 1,
"editable_count": 0,
"editor_widget": "appearance preset selector",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"default_source": "Compact Ops recipe tokens",
"summary": "Style fields use the appearance preset selector across 0/1 editable field."
},
{
"id": "content",
"label": "Content",
"field_role": "content",
"field_count": 5,
"editable_count": 5,
"editor_widget": "plain content field",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"default_source": "cloneable block recipe payload",
"summary": "Content fields use the plain content field across 5/5 editable fields."
}
],
"editor_field_roles": [
"copy",
"action",
"form",
"style",
"content"
],
"editor_editable_field_count": 15,
"state_readiness_count": 6,
"state_readiness_map": [
{
"id": "default",
"label": "Default",
"status": "covered",
"trigger": "Initial render with the cloneable recipe payload",
"visual_treatment": "Compact Ops tokens with dense documentation treatment",
"token_roles": [
"surface",
"panel",
"text",
"button"
],
"proof": "The Compact Ops recipe renders a contract-safe primary state for tax-estimator.",
"summary": "Default state uses the recipe surface, text, and action tokens without one-off styling."
},
{
"id": "empty",
"label": "Empty",
"status": "covered",
"trigger": "Repeatable collections have zero items",
"visual_treatment": "Reserved panel space with fallback copy or placeholder media",
"token_roles": [
"panel",
"textMuted",
"badge",
"border"
],
"proof": "Repeatable fields are documented for add, remove, reorder, and item-level editing.",
"summary": "Empty-state guidance preserves layout rhythm instead of collapsing the block surface."
},
{
"id": "pending",
"label": "Pending",
"status": "covered",
"trigger": "Async assignment, embed load, or form submission is in flight",
"visual_treatment": "Neutral reserved frame with status copy and no layout shift",
"token_roles": [
"control",
"textMuted",
"progressTrack",
"border"
],
"proof": "Async-capable props are mapped through controls, events, or provider placeholders.",
"summary": "Pending state keeps dimensions stable while using muted control/status tokens."
},
{
"id": "active",
"label": "Active",
"status": "covered",
"trigger": "Selected action, active link, checked input, or open disclosure",
"visual_treatment": "Signal/uplink emphasis with visible selected-state chips",
"token_roles": [
"signal",
"uplink",
"button",
"badge"
],
"proof": "1 action surface and 2 control surfaces are mapped for selected-state review.",
"summary": "Active state is represented with recipe accent tokens and visible state labels."
},
{
"id": "invalid",
"label": "Invalid",
"status": "covered",
"trigger": "Required input, option, or submitted value is invalid",
"visual_treatment": "Warning/danger status treatment while preserving the block frame",
"token_roles": [
"warning",
"danger",
"border",
"text"
],
"proof": "Form controls preserve labels, required state, options, and submission metadata.",
"summary": "Invalid state guidance favors explicit status evidence over ambiguous visual collapse."
},
{
"id": "disabled",
"label": "Disabled",
"status": "covered",
"trigger": "Unavailable action or temporarily disabled control",
"visual_treatment": "Muted affordance with preserved label, spacing, and hit-area rhythm",
"token_roles": [
"control",
"textMuted",
"border",
"panel"
],
"proof": "Interactive maps preserve labels and control roles so disabled states can stay understandable.",
"summary": "Disabled state keeps the block readable and spatially stable when interaction is unavailable."
}
],
"state_readiness_states": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"state_readiness_statuses": [
"covered",
"covered",
"covered",
"covered",
"covered",
"covered"
],
"anatomy_region_count": 5,
"anatomy_map": [
{
"id": "surface",
"label": "Surface",
"region_role": "outer layout and background",
"field_paths": [
"appearance"
],
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"region_role": "headings, body copy, labels, and supporting text",
"field_paths": [
"description",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"title"
],
"token_roles": [
"text",
"textMuted"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"region_role": "CTA, link, event, and navigation affordances",
"field_paths": [
"connect_cta"
],
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"region_role": "inputs, choices, form fields, and operator controls",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value",
"inputs[0]",
"inputs[1]"
],
"token_roles": [
"control",
"controlText",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"region_role": "status, validation, selected, loading, and disabled evidence",
"field_paths": [],
"token_roles": [
"badge",
"badgeText",
"signal"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"anatomy_regions": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"anatomy_token_roles": [
"background",
"badge",
"badgeText",
"border",
"button",
"buttonText",
"control",
"controlText",
"panel",
"panelElevated",
"signal",
"text",
"textMuted",
"uplink"
],
"action_count": 1,
"action_map": [
{
"path": "connect_cta",
"label": "Request review",
"action_type": "primary",
"href": "#block-preview",
"event_name": null,
"summary": "Request review is a primary action linking to #block-preview."
}
],
"control_count": 2,
"control_map": [
{
"path": "inputs[0]",
"label": "Filing or project size",
"control_type": "number",
"required": false,
"option_count": null,
"summary": "Filing or project size is a number control."
},
{
"path": "inputs[1]",
"label": "Timing",
"control_type": "select",
"required": false,
"option_count": 2,
"summary": "Timing is a select control with 2 options."
}
],
"style_token_count": 15,
"style_token_map": [
{
"role": "background",
"label": "Page background",
"value": "#f7fbff",
"token_type": "color",
"summary": "Page background uses the background recipe token."
},
{
"role": "panel",
"label": "Panel surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Panel surface uses the panel recipe token."
},
{
"role": "panelElevated",
"label": "Elevated surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Elevated surface uses the panelElevated recipe token."
},
{
"role": "text",
"label": "Primary text",
"value": "#142033",
"token_type": "color",
"summary": "Primary text uses the text recipe token."
},
{
"role": "textMuted",
"label": "Muted text",
"value": "#526174",
"token_type": "color",
"summary": "Muted text uses the textMuted recipe token."
},
{
"role": "signal",
"label": "Signal accent",
"value": "#166bff",
"token_type": "color",
"summary": "Signal accent uses the signal recipe token."
},
{
"role": "uplink",
"label": "Secondary accent",
"value": "#00a6a6",
"token_type": "color",
"summary": "Secondary accent uses the uplink recipe token."
},
{
"role": "border",
"label": "Border",
"value": "#d6dee8",
"token_type": "color",
"summary": "Border uses the border recipe token."
},
{
"role": "control",
"label": "Control surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Control surface uses the control recipe token."
},
{
"role": "controlText",
"label": "Control text",
"value": "#142033",
"token_type": "color",
"summary": "Control text uses the controlText recipe token."
},
{
"role": "button",
"label": "Button surface",
"value": "#166bff",
"token_type": "color",
"summary": "Button surface uses the button recipe token."
},
{
"role": "buttonText",
"label": "Button text",
"value": "#ffffff",
"token_type": "color",
"summary": "Button text uses the buttonText recipe token."
},
{
"role": "badge",
"label": "Badge surface",
"value": "#eef5ff",
"token_type": "color",
"summary": "Badge surface uses the badge recipe token."
},
{
"role": "badgeText",
"label": "Badge text",
"value": "#174ea6",
"token_type": "color",
"summary": "Badge text uses the badgeText recipe token."
},
{
"role": "fontFamily",
"label": "Font family",
"value": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
"token_type": "font",
"summary": "Font family comes from the active recipe theme tokens."
}
],
"style_token_roles": [
"background",
"panel",
"panelElevated",
"text",
"textMuted",
"signal",
"uplink",
"border",
"control",
"controlText",
"button",
"buttonText",
"badge",
"badgeText",
"fontFamily"
],
"contrast_check_count": 6,
"contrast_pass_count": 6,
"contrast_checks": [
{
"id": "text-on-background",
"label": "Text on background",
"foreground_role": "text",
"background_role": "background",
"foreground": "#142033",
"background": "#f7fbff",
"ratio": 15.73,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on background is AAA at 15.73:1 against a 4.5:1 requirement."
},
{
"id": "text-on-panel",
"label": "Text on panel",
"foreground_role": "text",
"background_role": "panel",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on panel is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "muted-text-on-panel",
"label": "Muted text on panel",
"foreground_role": "textMuted",
"background_role": "panel",
"foreground": "#526174",
"background": "#ffffff",
"ratio": 6.32,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Muted text on panel is AA at 6.32:1 against a 4.5:1 requirement."
},
{
"id": "button-text-on-button",
"label": "Button text on button",
"foreground_role": "buttonText",
"background_role": "button",
"foreground": "#ffffff",
"background": "#166bff",
"ratio": 4.58,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Button text on button is AA at 4.58:1 against a 4.5:1 requirement."
},
{
"id": "control-text-on-control",
"label": "Control text on control",
"foreground_role": "controlText",
"background_role": "control",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Control text on control is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "badge-text-on-badge",
"label": "Badge text on badge",
"foreground_role": "badgeText",
"background_role": "badge",
"foreground": "#174ea6",
"background": "#eef5ff",
"ratio": 7.15,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Badge text on badge is AAA at 7.15:1 against a 4.5:1 requirement."
}
],
"contrast_target": "AA",
"accessibility_standard": "WCAG_2_2_AA",
"accessibility_check_count": 5,
"accessibility_checks": [
{
"id": "semantic-structure",
"label": "Semantic structure",
"category": "semantics",
"status": "covered",
"required": true,
"proof": "runtime block sections, cards, lists, and headings",
"summary": "tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview."
},
{
"id": "keyboard-and-tap-targets",
"label": "Keyboard and tap targets",
"category": "keyboard",
"status": "covered",
"required": true,
"proof": "mapped actions/controls render as native focusable surfaces",
"summary": "Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances."
},
{
"id": "text-alternatives",
"label": "Text alternatives",
"category": "media",
"status": "covered",
"required": false,
"proof": "media slots collapse when unused",
"summary": "Recipes without media do not leave decorative media shells that need alt text."
},
{
"id": "control-labels",
"label": "Control labels",
"category": "forms",
"status": "covered",
"required": true,
"proof": "control map includes required field labels and option metadata",
"summary": "Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review."
},
{
"id": "status-and-motion",
"label": "Status and motion",
"category": "state",
"status": "covered",
"required": true,
"proof": "runtime evidence avoids hidden status-only content",
"summary": "Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present."
}
],
"responsive_behavior_count": 3,
"responsive_behavior_map": [
{
"id": "phone",
"label": "Phone",
"viewport_width": 390,
"layout_mode": "single-column stack",
"column_count": 1,
"spacing_density": "compact",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-phone",
"summary": "Compact Ops stacks tax-estimator into one phone column with compact spacing and bounded content."
},
{
"id": "tablet",
"label": "Tablet",
"viewport_width": 768,
"layout_mode": "two-column adaptive grid",
"column_count": 2,
"spacing_density": "compact",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-tablet",
"summary": "Compact Ops adapts tax-estimator to 2 tablet columns before expanding to the desktop layout."
},
{
"id": "desktop",
"label": "Desktop",
"viewport_width": 1366,
"layout_mode": "responsive composition grid",
"column_count": 2,
"spacing_density": "compact",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-desktop",
"summary": "Compact Ops gives tax-estimator up to 2 desktop columns while preserving recipe spacing."
}
],
"responsive_viewports": [
"phone",
"tablet",
"desktop"
],
"responsive_proof": [
"npm run test:static:block-catalog all-blocks-phone",
"npm run test:static:block-catalog all-blocks-tablet",
"npm run test:static:block-catalog all-blocks-desktop"
],
"interactive_roles": [
"number",
"primary",
"select"
],
"recipe_alignment": {
"action_token": "button",
"control_token": "control",
"surface_token": "panel",
"text_token": "text",
"source": "theme recipe tokens"
}
},
"cloneable": true
}
}Long Copy Stress
Editorial Block Systemstress
A resilience payload with plausible long CMS copy, longer labels, and dense supporting metadata to prove wrapping and spacing.
Component anatomy
5 regionsLong Copy Stress anatomy
Surfaceouter layout and background
tax-estimator uses recipe surface tokens to keep the outer frame styled and composable.
background, panel, panelElevated, borderCopyheadings, body copy, labels, and supporting text
Copy fields map to primary and muted text roles so editors can change words without restyling the block.
text, textMutedActionsCTA, link, event, and navigation affordances
Action regions use recipe button and accent tokens while preserving href or event payloads.
button, buttonText, signal, uplinkControlsinputs, choices, form fields, and operator controls
Control regions keep labels, required state, and options aligned with recipe control tokens.
control, controlText, borderFeedbackstatus, validation, selected, loading, and disabled evidence
Feedback regions tie state-readiness evidence to visible recipe status treatments.
badge, badgeText, signalRecipe passport
highLong Copy Stress passport
Use to verify tax-estimator long copy, awkward values, and wrapping before publishing customer pages.
Long Copy Stress is a high-complexity stress-test recipe with 5 documented composition slots.
3 required regions, 2 optional regions.
Slots
Surface / 0/1Copy / 8/8Actions / 2/2Controls / 4/6Feedback / 0/0
Replacement guidance
- Keep Editorial Block System recipe tokens as the source of visual styling for the surface, text, controls, and actions.
- No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.
- Verify each action keeps either a valid href or canonical event name plus an editor-visible label.
- Verify control labels, required state, choices, and submission metadata before publishing.
- The recipe does not require repeatable collection editing.
Publish checklist
- Validate tax-estimator against its block contract before publishing.
- 3 required anatomy regions remain present: surface, copy, feedback.
- 19/20 builder fields are CMS-editable or intentionally locked.
- Interactive labels, target size, href/event wiring, and disabled states have been reviewed.
- Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.
- Contrast checks meet the AA recipe target.
Recipe fit
6 axesLong Copy Stress recipe fit
Page contextpage / supporting
funnelcontactservice-pageblog
tax-estimator is best composed into funnel, contact, service-page, and related pages.
4 page types mapped for tax-estimator.Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.Section rolelayout / primary
conversioncontentform-controls
tax-estimator can act as conversion, content, form-controls within a composed page.
5 anatomy regions produce 3 section roles.Place the block where its required anatomy regions have enough room before compressing it into dense page slots.Content modelcontent / supporting
copy-ledcta-ledinput-led
Long Copy Stress composition passport is copy-led, cta-led, input-led for CMS composition.
19/20 fields are editable across 3 content models.Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.Interaction modelinteraction / primary
primary-linknumberselect
tax-estimator carries primary-link, number, select interaction affordances.
1 action surface and 2 control surfaces mapped.Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.Authoring fitauthoring / specialized
stress-testhigh-complexity7-high-care-replacements
tax-estimator uses stress-test authoring with high complexity.
20 default provenance items with 7 high-care replacements.Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.Responsive fitresponsive / primary
single-column stacktwo-column adaptive gridresponsive composition gridmin-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.
tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages.
3 responsive behavior maps cover phone, tablet, and desktop composition.Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.Visual polish
6/6Long Copy Stress visual polish
Surface rhythmlayout
tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers.
editorial treatment uses spacious density and 8px radius base.background, panel, panelElevated, borderType hierarchytypography
Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text.
6/6 contrast checks pass the AA target.text, textMuted, badgeTextAction clarityinteraction
Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options.
1 action surface and 2 control surfaces mapped.button, buttonText, control, controlText, signal, uplinkMedia treatmentmedia
The recipe remains polished without requiring placeholder media or visual assets inside this block.
No media region is required for this recipe.panelElevated, border, textMutedState feedbackstate
Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning.
6 state-readiness entries include default, empty, pending, active, invalid, disabled.badge, badgeText, signalResponsive balanceresponsive
Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe.
single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.panel, border, controlDefault provenance
20 fieldsLong Copy Stress default provenance
collection-itemlocked-tokenrequires-action-targetrequires-control-optionssafe-to-edit
- Appearanceappearance
Keep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes.
Editorial Block System recipe tokens - Titletitle
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Descriptiondescription
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Modemode
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Inputsinputs
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Labelinputs[].label
Preserve control labels, required state, choices, submission metadata, and validation copy.
cloneable block recipe payload - Inputs Item Typeinputs[].type
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Valueinputs[].value
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Inputs Item Unitinputs[].unit
Preserve control labels, required state, choices, submission metadata, and validation copy.
CMS form schema or tenant data-capture defaults - Outputsoutputs
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Outputs Item Labeloutputs[].label
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Valueoutputs[].value
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Outputs Item Descriptionoutputs[].description
Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.
cloneable block recipe payload - Assumptionsassumptions
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Connect Ctaconnect_cta
Keep the label paired with a valid href or canonical postEvent event name before publishing.
CMS route, URL, or canonical postEvent path - Disclaimerdisclaimer
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Headlineheadline
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Subtitlesubtitle
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - Captioncaption
Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.
cloneable block recipe payload - ButtonTextbuttonText
Keep the label paired with a valid href or canonical postEvent event name before publishing.
CMS route, URL, or canonical postEvent path
Edit bundles
5 bundlesLong Copy Stress edit bundles
Copy bundlerequired / repeatable-items
captiondescriptionheadlineinputs[].labeloutputs[].descriptionoutputs[].label+2
Copy bundle groups 8 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.Action bundlerecommended / grouped-fields
buttonTextconnect_cta
Action bundle groups 2 fields so CMS edits preserve the recipe shape and default polish.
CMS route, URL, or canonical postEvent pathKeep the label paired with a valid href or canonical postEvent event name before publishing.Control bundlerecommended / repeatable-items
inputsinputs[].typeinputs[].unitinputs[].value
Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish.
CMS form schema or tenant data-capture defaultsPreserve control labels, required state, choices, submission metadata, and validation copy.Style bundleguarded / guarded-system
appearance
Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish.
Editorial Block System recipe tokensKeep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes.Content bundlerequired / repeatable-items
assumptionsdisclaimermodeoutputsoutputs[].value
Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish.
cloneable block recipe payloadCopy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.CMS composition
20 fieldsLong Copy Stress fields
actioncontentcopyformstyle
- Appearanceappearance
- Titletitle
- Descriptiondescription
- Modemode
- Inputsinputs
- Inputs Item Labelinputs[].label
- Inputs Item Typeinputs[].type
- Inputs Item Valueinputs[].value
- Inputs Item Unitinputs[].unit
- Outputsoutputs
- Outputs Item Labeloutputs[].label
- Outputs Item Valueoutputs[].value
- Outputs Item Descriptionoutputs[].description
- Assumptionsassumptions
- Connect Ctaconnect_cta
- Disclaimerdisclaimer
- Headlineheadline
- Subtitlesubtitle
- Captioncaption
- ButtonTextbuttonText
CMS editing
19/20 editableLong Copy Stress editor guidance
Copytext/rich-text editor
Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.
cloneable block recipe payloadActionlink or event action editor
Actions should resolve to a URL or event name with a human-readable label.
CMS route, URL, or canonical postEvent pathFormform schema and input editor
Form fields should preserve labels, required state, options, and submission metadata.
CMS form schema or tenant data-capture defaultsStyleappearance preset selector
Style fields should prefer recipe or appearance tokens over one-off inline values.
Editorial Block System recipe tokensContentplain content field
Content should remain serializable JSON and preserve the documented block contract.
cloneable block recipe payloadDefault states
6 statesLong Copy Stress state readiness
DefaultInitial render with the cloneable recipe payload
Editorial Block System tokens with editorial documentation treatment
The Editorial Block System recipe renders a contract-safe primary state for tax-estimator.EmptyRepeatable collections have zero items
Reserved panel space with fallback copy or placeholder media
Repeatable fields are documented for add, remove, reorder, and item-level editing.PendingAsync assignment, embed load, or form submission is in flight
Neutral reserved frame with status copy and no layout shift
Async-capable props are mapped through controls, events, or provider placeholders.ActiveSelected action, active link, checked input, or open disclosure
Signal/uplink emphasis with visible selected-state chips
1 action surface and 2 control surfaces are mapped for selected-state review.InvalidRequired input, option, or submitted value is invalid
Warning/danger status treatment while preserving the block frame
Form controls preserve labels, required state, options, and submission metadata.DisabledUnavailable action or temporarily disabled control
Muted affordance with preserved label, spacing, and hit-area rhythm
Interactive maps preserve labels and control roles so disabled states can stay understandable.Controls and actions
3 surfacesLong Copy Stress actions and controls
primarynumberselect
Actions
- Request reviewconnect_cta
Controls
- Filing or project sizeinputs[0]
- Timinginputs[1]
Recipe styling
15 tokensLong Copy Stress style tokens
Page background#f7fbff
Panel surface#ffffff
Elevated surface#ffffff
Primary text#142033
Muted text#526174
Signal accent#166bff
Secondary accent#00a6a6
Border#d6dee8
Control surface#ffffff
Control text#142033
Button surface#166bff
Button text#ffffff
Badge surface#eef5ff
Badge text#174ea6
Font familyInter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
Readability
6/6Long Copy Stress contrast checks
Text on background15.73:1 / AAA
Text on panel16.35:1 / AAA
Muted text on panel6.32:1 / AA
Button text on button4.58:1 / AA
Control text on control16.35:1 / AAA
Badge text on badge7.15:1 / AAA
Accessibility proof
WCAG 2.2 AALong Copy Stress accessibility checks
Semantic structuresemantics / required
tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview.
runtime block sections, cards, lists, and headingsKeyboard and tap targetskeyboard / required
Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances.
mapped actions/controls render as native focusable surfacesText alternativesmedia / contextual
Recipes without media do not leave decorative media shells that need alt text.
media slots collapse when unusedControl labelsforms / required
Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review.
control map includes required field labels and option metadataStatus and motionstate / required
Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present.
runtime evidence avoids hidden status-only contentResponsive proof
3 viewportsLong Copy Stress responsive behavior
Phone390px / single-column stack
Editorial Block System stacks tax-estimator into one phone column with spacious spacing and bounded content.
min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.Tablet768px / two-column adaptive grid
Editorial Block System adapts tax-estimator to 2 tablet columns before expanding to the desktop layout.
tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.Desktop1366px / responsive composition grid
Editorial Block System gives tax-estimator up to 2 desktop columns while preserving recipe spacing.
desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.Estimator Calculator with a realistic CMS-authored headline that wraps cleanly across compact cards, mobile panels, and generated documentation frames
This intentionally longer copy uses normal words, punctuation, and CMS-style details so the block proves it can remain polished with production-length titles, helper text, labels, badges, links, and nested content.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Structured payload
{
"id": "block-doc-tax-estimator-data-long-copy-stress",
"block_type": "tax-estimator",
"props": {
"appearance": {
"preset": "block"
},
"title": "Estimator Calculator with a realistic CMS-authored headline that wraps cleanly across compact cards, mobile panels, and generated documentation frames",
"description": "This intentionally longer copy uses normal words, punctuation, and CMS-style details so the block proves it can remain polished with production-length titles, helper text, labels, badges, links, and nested content.",
"mode": "tax",
"inputs": [
{
"label": "Filing or project size",
"type": "number",
"value": "2",
"unit": "units"
},
{
"label": "Timing",
"type": "select",
"value": "This quarter",
"options": [
"This quarter",
"Next quarter"
]
}
],
"outputs": [
{
"label": "Estimated range",
"value": "$1,200-$2,400",
"description": "Demo-only range based on local assumptions."
},
{
"label": "Review needed",
"value": "Human confirmation required",
"description": "Final numbers require provider review."
}
],
"assumptions": [
"Uses example content only",
"No submission or stored calculation is created"
],
"connect_cta": {
"text": "Request review",
"href": "#block-preview"
},
"disclaimer": "This estimator is informational and does not provide binding advice, pricing, or eligibility.",
"headline": "Estimator Calculator with a realistic CMS-authored headline that wraps cleanly across compact cards, mobile panels, and generated documentation frames",
"subtitle": "This intentionally longer copy uses normal words, punctuation, and CMS-style details so the block proves it can remain polished with production-length titles, helper text, labels, badges, links, and nested content.",
"caption": "Replaceable media caption with enough source context to wrap onto multiple lines without crowding adjacent controls.",
"buttonText": "Continue with the guided CMS review"
},
"metadata": {
"long_copy_tolerance": true,
"awkward_content_tolerance": true,
"composition_recipe": {
"id": "long-copy-stress",
"intent": "stress",
"label": "Long Copy Stress",
"recipe": "editorial-block-system",
"source": "block-explorer",
"quality_proof": [
"long_copy_tolerance",
"awkward_content_tolerance"
],
"composition_passport": {
"id": "long-copy-stress",
"label": "Long Copy Stress composition passport",
"intent": "stress",
"recipe": "editorial-block-system",
"authoring_mode": "stress-test",
"complexity": "high",
"fit": "Use to verify tax-estimator long copy, awkward values, and wrapping before publishing customer pages.",
"required_regions": [
"surface",
"copy",
"feedback"
],
"optional_regions": [
"actions",
"controls"
],
"slots": [
{
"id": "surface",
"label": "Surface",
"required": true,
"field_count": 1,
"editable_count": 0,
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"required": true,
"field_count": 8,
"editable_count": 8,
"token_roles": [
"text",
"textMuted"
],
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"required": false,
"field_count": 2,
"editable_count": 2,
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"required": false,
"field_count": 6,
"editable_count": 4,
"token_roles": [
"control",
"controlText",
"border"
],
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"required": true,
"field_count": 0,
"editable_count": 0,
"token_roles": [
"badge",
"badgeText",
"signal"
],
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"builder_field_count": 20,
"editable_field_count": 19,
"action_count": 1,
"control_count": 2,
"replacement_guidance": [
"Keep Editorial Block System recipe tokens as the source of visual styling for the surface, text, controls, and actions.",
"No media replacement is required; keep the layout rhythm stable when optional visual fields are omitted.",
"Verify each action keeps either a valid href or canonical event name plus an editor-visible label.",
"Verify control labels, required state, choices, and submission metadata before publishing.",
"The recipe does not require repeatable collection editing."
],
"publish_checklist": [
"Validate tax-estimator against its block contract before publishing.",
"3 required anatomy regions remain present: surface, copy, feedback.",
"19/20 builder fields are CMS-editable or intentionally locked.",
"Interactive labels, target size, href/event wiring, and disabled states have been reviewed.",
"Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.",
"Contrast checks meet the AA recipe target."
],
"agent_notes": [
"Prefer editing props fields described by the builder field map; metadata is evidence, not primary content.",
"Preserve recipe_alignment token roles unless the page theme or recipe changes intentionally.",
"Use the anatomy slots to compose or replace content without changing the block type."
],
"summary": "Long Copy Stress is a high-complexity stress-test recipe with 5 documented composition slots."
},
"composition_passport_complexity": "high",
"composition_passport_authoring_mode": "stress-test",
"composition_passport_slots": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"composition_passport_check_count": 6,
"visual_polish_check_count": 6,
"visual_polish_pass_count": 6,
"visual_polish_checks": [
{
"id": "surface-rhythm",
"label": "Surface rhythm",
"axis": "layout",
"status": "ready",
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"evidence": "editorial treatment uses spacious density and 8px radius base.",
"summary": "tax-estimator keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers."
},
{
"id": "type-hierarchy",
"label": "Type hierarchy",
"axis": "typography",
"status": "ready",
"token_roles": [
"text",
"textMuted",
"badgeText"
],
"evidence": "6/6 contrast checks pass the AA target.",
"summary": "Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text."
},
{
"id": "action-clarity",
"label": "Action clarity",
"axis": "interaction",
"status": "ready",
"token_roles": [
"button",
"buttonText",
"control",
"controlText",
"signal",
"uplink"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"summary": "Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options."
},
{
"id": "media-treatment",
"label": "Media treatment",
"axis": "media",
"status": "ready",
"token_roles": [
"panelElevated",
"border",
"textMuted"
],
"evidence": "No media region is required for this recipe.",
"summary": "The recipe remains polished without requiring placeholder media or visual assets inside this block."
},
{
"id": "state-feedback",
"label": "State feedback",
"axis": "state",
"status": "ready",
"token_roles": [
"badge",
"badgeText",
"signal"
],
"evidence": "6 state-readiness entries include default, empty, pending, active, invalid, disabled.",
"summary": "Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning."
},
{
"id": "responsive-balance",
"label": "Responsive balance",
"axis": "responsive",
"status": "ready",
"token_roles": [
"panel",
"border",
"control"
],
"evidence": "single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.",
"summary": "Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe."
}
],
"visual_polish_axes": [
"layout",
"typography",
"interaction",
"media",
"state",
"responsive"
],
"default_provenance_count": 20,
"default_provenance_map": [
{
"path": "appearance",
"label": "Appearance",
"field_role": "style",
"value_type": "object",
"editable": false,
"repeated": false,
"default_source": "Editorial Block System recipe tokens",
"replacement_policy": "locked-token",
"replacement_risk": "medium",
"guardrail": "Keep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes.",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"summary": "Appearance defaults from Editorial Block System recipe tokens; replacement is medium risk with locked-token policy."
},
{
"path": "title",
"label": "Title",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Title defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "description",
"label": "Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Description defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "mode",
"label": "Mode",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Mode defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "inputs",
"label": "Inputs",
"field_role": "form",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Inputs Item Label defaults from cloneable block recipe payload; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Type defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Value defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"field_role": "form",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "CMS form schema or tenant data-capture defaults",
"replacement_policy": "requires-control-options",
"replacement_risk": "high",
"guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"summary": "Inputs Item Unit defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
},
{
"path": "outputs",
"label": "Outputs",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Outputs Item Value defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": true,
"default_source": "cloneable block recipe payload",
"replacement_policy": "collection-item",
"replacement_risk": "medium",
"guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Outputs Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
},
{
"path": "assumptions",
"label": "Assumptions",
"field_role": "content",
"value_type": "array",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Assumptions defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"field_role": "action",
"value_type": "object",
"editable": true,
"repeated": false,
"default_source": "CMS route, URL, or canonical postEvent path",
"replacement_policy": "requires-action-target",
"replacement_risk": "high",
"guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"summary": "Connect Cta defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"field_role": "content",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"summary": "Disclaimer defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "headline",
"label": "Headline",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Headline defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "subtitle",
"label": "Subtitle",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Subtitle defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "caption",
"label": "Caption",
"field_role": "copy",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "cloneable block recipe payload",
"replacement_policy": "safe-to-edit",
"replacement_risk": "low",
"guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"summary": "Caption defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
},
{
"path": "buttonText",
"label": "ButtonText",
"field_role": "action",
"value_type": "string",
"editable": true,
"repeated": false,
"default_source": "CMS route, URL, or canonical postEvent path",
"replacement_policy": "requires-action-target",
"replacement_risk": "high",
"guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"summary": "ButtonText defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
}
],
"default_replacement_policies": [
"collection-item",
"locked-token",
"requires-action-target",
"requires-control-options",
"safe-to-edit"
],
"default_replacement_risks": [
"high",
"low",
"medium"
],
"default_replacement_high_risk_count": 7,
"content_edit_bundle_count": 5,
"content_edit_bundles": [
{
"id": "copy",
"label": "Copy bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"caption",
"description",
"headline",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"subtitle",
"title"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Preserve control labels, required state, choices, submission metadata, and validation copy.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"type hierarchy",
"mobile wrapping"
],
"summary": "Copy bundle groups 8 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "actions",
"label": "Action bundle",
"intent": "recommended",
"edit_mode": "grouped-fields",
"field_paths": [
"buttonText",
"connect_cta"
],
"default_sources": [
"CMS route, URL, or canonical postEvent path"
],
"guardrails": [
"Keep the label paired with a valid href or canonical postEvent event name before publishing."
],
"depends_on": [
"copy labels",
"href or event target",
"state readiness"
],
"summary": "Action bundle groups 2 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "controls",
"label": "Control bundle",
"intent": "recommended",
"edit_mode": "repeatable-items",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value"
],
"default_sources": [
"CMS form schema or tenant data-capture defaults"
],
"guardrails": [
"Preserve control labels, required state, choices, submission metadata, and validation copy."
],
"depends_on": [
"field labels",
"required state",
"disabled state"
],
"summary": "Control bundle groups 4 fields so CMS edits preserve the recipe shape and default polish."
},
{
"id": "style",
"label": "Style bundle",
"intent": "guarded",
"edit_mode": "guarded-system",
"field_paths": [
"appearance"
],
"default_sources": [
"Editorial Block System recipe tokens"
],
"guardrails": [
"Keep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes."
],
"depends_on": [
"theme recipe tokens",
"contrast proof"
],
"summary": "Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
},
{
"id": "content",
"label": "Content bundle",
"intent": "required",
"edit_mode": "repeatable-items",
"field_paths": [
"assumptions",
"disclaimer",
"mode",
"outputs",
"outputs[].value"
],
"default_sources": [
"cloneable block recipe payload"
],
"guardrails": [
"Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
"Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
],
"depends_on": [
"contract-safe JSON"
],
"summary": "Content bundle groups 5 fields so CMS edits preserve the recipe shape and default polish."
}
],
"content_edit_bundle_ids": [
"copy",
"actions",
"controls",
"style",
"content"
],
"content_edit_bundle_modes": [
"grouped-fields",
"guarded-system",
"repeatable-items"
],
"content_edit_bundle_required_count": 2,
"content_edit_bundle_guarded_count": 1,
"recipe_compatibility_count": 6,
"recipe_compatibility_map": [
{
"id": "page-context",
"label": "Page context",
"axis": "page",
"fit": "supporting",
"values": [
"funnel",
"contact",
"service-page",
"blog"
],
"evidence": "4 page types mapped for tax-estimator.",
"guardrail": "Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.",
"summary": "tax-estimator is best composed into funnel, contact, service-page, and related pages."
},
{
"id": "section-role",
"label": "Section role",
"axis": "layout",
"fit": "primary",
"values": [
"conversion",
"content",
"form-controls"
],
"evidence": "5 anatomy regions produce 3 section roles.",
"guardrail": "Place the block where its required anatomy regions have enough room before compressing it into dense page slots.",
"summary": "tax-estimator can act as conversion, content, form-controls within a composed page."
},
{
"id": "content-model",
"label": "Content model",
"axis": "content",
"fit": "supporting",
"values": [
"copy-led",
"cta-led",
"input-led"
],
"evidence": "19/20 fields are editable across 3 content models.",
"guardrail": "Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.",
"summary": "Long Copy Stress composition passport is copy-led, cta-led, input-led for CMS composition."
},
{
"id": "interaction-model",
"label": "Interaction model",
"axis": "interaction",
"fit": "primary",
"values": [
"primary-link",
"number",
"select"
],
"evidence": "1 action surface and 2 control surfaces mapped.",
"guardrail": "Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.",
"summary": "tax-estimator carries primary-link, number, select interaction affordances."
},
{
"id": "authoring-fit",
"label": "Authoring fit",
"axis": "authoring",
"fit": "specialized",
"values": [
"stress-test",
"high-complexity",
"7-high-care-replacements"
],
"evidence": "20 default provenance items with 7 high-care replacements.",
"guardrail": "Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.",
"summary": "tax-estimator uses stress-test authoring with high complexity."
},
{
"id": "responsive-fit",
"label": "Responsive fit",
"axis": "responsive",
"fit": "primary",
"values": [
"single-column stack",
"two-column adaptive grid",
"responsive composition grid",
"min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke."
],
"evidence": "3 responsive behavior maps cover phone, tablet, and desktop composition.",
"guardrail": "Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.",
"summary": "tax-estimator has explicit phone, tablet, and desktop compatibility evidence for composed pages."
}
],
"recipe_compatibility_axes": [
"page",
"layout",
"content",
"interaction",
"authoring",
"responsive"
],
"recipe_compatibility_page_types": [
"funnel",
"contact",
"service-page",
"blog"
],
"recipe_compatibility_section_roles": [
"conversion",
"content",
"form-controls"
],
"recipe_compatibility_fits": [
"primary",
"specialized",
"supporting"
],
"builder_field_count": 20,
"builder_field_map": [
{
"path": "appearance",
"label": "Appearance",
"value_type": "object",
"role": "style",
"editable": false,
"repeated": false,
"summary": "Appearance is a object field used for style."
},
{
"path": "title",
"label": "Title",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Title is a string field used for copy."
},
{
"path": "description",
"label": "Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Description is a string field used for copy."
},
{
"path": "mode",
"label": "Mode",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Mode is a string field used for content."
},
{
"path": "inputs",
"label": "Inputs",
"value_type": "array",
"role": "form",
"editable": true,
"repeated": false,
"summary": "Inputs is a array field used for form."
},
{
"path": "inputs[].label",
"label": "Inputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Inputs Item Label is a string collection field used for copy."
},
{
"path": "inputs[].type",
"label": "Inputs Item Type",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Type is a string collection field used for form."
},
{
"path": "inputs[].value",
"label": "Inputs Item Value",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Value is a string collection field used for form."
},
{
"path": "inputs[].unit",
"label": "Inputs Item Unit",
"value_type": "string",
"role": "form",
"editable": true,
"repeated": true,
"summary": "Inputs Item Unit is a string collection field used for form."
},
{
"path": "outputs",
"label": "Outputs",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Outputs is a array field used for content."
},
{
"path": "outputs[].label",
"label": "Outputs Item Label",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Label is a string collection field used for copy."
},
{
"path": "outputs[].value",
"label": "Outputs Item Value",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": true,
"summary": "Outputs Item Value is a string collection field used for content."
},
{
"path": "outputs[].description",
"label": "Outputs Item Description",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": true,
"summary": "Outputs Item Description is a string collection field used for copy."
},
{
"path": "assumptions",
"label": "Assumptions",
"value_type": "array",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Assumptions is a array field used for content."
},
{
"path": "connect_cta",
"label": "Connect Cta",
"value_type": "object",
"role": "action",
"editable": true,
"repeated": false,
"summary": "Connect Cta is a object field used for action."
},
{
"path": "disclaimer",
"label": "Disclaimer",
"value_type": "string",
"role": "content",
"editable": true,
"repeated": false,
"summary": "Disclaimer is a string field used for content."
},
{
"path": "headline",
"label": "Headline",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Headline is a string field used for copy."
},
{
"path": "subtitle",
"label": "Subtitle",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Subtitle is a string field used for copy."
},
{
"path": "caption",
"label": "Caption",
"value_type": "string",
"role": "copy",
"editable": true,
"repeated": false,
"summary": "Caption is a string field used for copy."
},
{
"path": "buttonText",
"label": "ButtonText",
"value_type": "string",
"role": "action",
"editable": true,
"repeated": false,
"summary": "ButtonText is a string field used for action."
}
],
"editor_guidance_count": 5,
"editor_guidance_map": [
{
"id": "copy",
"label": "Copy",
"field_role": "copy",
"field_count": 8,
"editable_count": 8,
"editor_widget": "text/rich-text editor",
"validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
"default_source": "cloneable block recipe payload",
"summary": "Copy fields use the text/rich-text editor across 8/8 editable fields."
},
{
"id": "action",
"label": "Action",
"field_role": "action",
"field_count": 2,
"editable_count": 2,
"editor_widget": "link or event action editor",
"validation": "Actions should resolve to a URL or event name with a human-readable label.",
"default_source": "CMS route, URL, or canonical postEvent path",
"summary": "Action fields use the link or event action editor across 2/2 editable fields."
},
{
"id": "form",
"label": "Form",
"field_role": "form",
"field_count": 4,
"editable_count": 4,
"editor_widget": "form schema and input editor",
"validation": "Form fields should preserve labels, required state, options, and submission metadata.",
"default_source": "CMS form schema or tenant data-capture defaults",
"summary": "Form fields use the form schema and input editor across 4/4 editable fields."
},
{
"id": "style",
"label": "Style",
"field_role": "style",
"field_count": 1,
"editable_count": 0,
"editor_widget": "appearance preset selector",
"validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
"default_source": "Editorial Block System recipe tokens",
"summary": "Style fields use the appearance preset selector across 0/1 editable field."
},
{
"id": "content",
"label": "Content",
"field_role": "content",
"field_count": 5,
"editable_count": 5,
"editor_widget": "plain content field",
"validation": "Content should remain serializable JSON and preserve the documented block contract.",
"default_source": "cloneable block recipe payload",
"summary": "Content fields use the plain content field across 5/5 editable fields."
}
],
"editor_field_roles": [
"copy",
"action",
"form",
"style",
"content"
],
"editor_editable_field_count": 19,
"state_readiness_count": 6,
"state_readiness_map": [
{
"id": "default",
"label": "Default",
"status": "covered",
"trigger": "Initial render with the cloneable recipe payload",
"visual_treatment": "Editorial Block System tokens with editorial documentation treatment",
"token_roles": [
"surface",
"panel",
"text",
"button"
],
"proof": "The Editorial Block System recipe renders a contract-safe primary state for tax-estimator.",
"summary": "Default state uses the recipe surface, text, and action tokens without one-off styling."
},
{
"id": "empty",
"label": "Empty",
"status": "covered",
"trigger": "Repeatable collections have zero items",
"visual_treatment": "Reserved panel space with fallback copy or placeholder media",
"token_roles": [
"panel",
"textMuted",
"badge",
"border"
],
"proof": "Repeatable fields are documented for add, remove, reorder, and item-level editing.",
"summary": "Empty-state guidance preserves layout rhythm instead of collapsing the block surface."
},
{
"id": "pending",
"label": "Pending",
"status": "covered",
"trigger": "Async assignment, embed load, or form submission is in flight",
"visual_treatment": "Neutral reserved frame with status copy and no layout shift",
"token_roles": [
"control",
"textMuted",
"progressTrack",
"border"
],
"proof": "Async-capable props are mapped through controls, events, or provider placeholders.",
"summary": "Pending state keeps dimensions stable while using muted control/status tokens."
},
{
"id": "active",
"label": "Active",
"status": "covered",
"trigger": "Selected action, active link, checked input, or open disclosure",
"visual_treatment": "Signal/uplink emphasis with visible selected-state chips",
"token_roles": [
"signal",
"uplink",
"button",
"badge"
],
"proof": "1 action surface and 2 control surfaces are mapped for selected-state review.",
"summary": "Active state is represented with recipe accent tokens and visible state labels."
},
{
"id": "invalid",
"label": "Invalid",
"status": "covered",
"trigger": "Required input, option, or submitted value is invalid",
"visual_treatment": "Warning/danger status treatment while preserving the block frame",
"token_roles": [
"warning",
"danger",
"border",
"text"
],
"proof": "Form controls preserve labels, required state, options, and submission metadata.",
"summary": "Invalid state guidance favors explicit status evidence over ambiguous visual collapse."
},
{
"id": "disabled",
"label": "Disabled",
"status": "covered",
"trigger": "Unavailable action or temporarily disabled control",
"visual_treatment": "Muted affordance with preserved label, spacing, and hit-area rhythm",
"token_roles": [
"control",
"textMuted",
"border",
"panel"
],
"proof": "Interactive maps preserve labels and control roles so disabled states can stay understandable.",
"summary": "Disabled state keeps the block readable and spatially stable when interaction is unavailable."
}
],
"state_readiness_states": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"state_readiness_statuses": [
"covered",
"covered",
"covered",
"covered",
"covered",
"covered"
],
"anatomy_region_count": 5,
"anatomy_map": [
{
"id": "surface",
"label": "Surface",
"region_role": "outer layout and background",
"field_paths": [
"appearance"
],
"token_roles": [
"background",
"panel",
"panelElevated",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "tax-estimator uses recipe surface tokens to keep the outer frame styled and composable."
},
{
"id": "copy",
"label": "Copy",
"region_role": "headings, body copy, labels, and supporting text",
"field_paths": [
"caption",
"description",
"headline",
"inputs[].label",
"outputs[].description",
"outputs[].label",
"subtitle",
"title"
],
"token_roles": [
"text",
"textMuted"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
},
{
"id": "actions",
"label": "Actions",
"region_role": "CTA, link, event, and navigation affordances",
"field_paths": [
"buttonText",
"connect_cta"
],
"token_roles": [
"button",
"buttonText",
"signal",
"uplink"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
},
{
"id": "controls",
"label": "Controls",
"region_role": "inputs, choices, form fields, and operator controls",
"field_paths": [
"inputs",
"inputs[].type",
"inputs[].unit",
"inputs[].value",
"inputs[0]",
"inputs[1]"
],
"token_roles": [
"control",
"controlText",
"border"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": false,
"summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
},
{
"id": "feedback",
"label": "Feedback",
"region_role": "status, validation, selected, loading, and disabled evidence",
"field_paths": [],
"token_roles": [
"badge",
"badgeText",
"signal"
],
"state_ids": [
"default",
"empty",
"pending",
"active",
"invalid",
"disabled"
],
"required": true,
"summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
}
],
"anatomy_regions": [
"surface",
"copy",
"actions",
"controls",
"feedback"
],
"anatomy_token_roles": [
"background",
"badge",
"badgeText",
"border",
"button",
"buttonText",
"control",
"controlText",
"panel",
"panelElevated",
"signal",
"text",
"textMuted",
"uplink"
],
"action_count": 1,
"action_map": [
{
"path": "connect_cta",
"label": "Request review",
"action_type": "primary",
"href": "#block-preview",
"event_name": null,
"summary": "Request review is a primary action linking to #block-preview."
}
],
"control_count": 2,
"control_map": [
{
"path": "inputs[0]",
"label": "Filing or project size",
"control_type": "number",
"required": false,
"option_count": null,
"summary": "Filing or project size is a number control."
},
{
"path": "inputs[1]",
"label": "Timing",
"control_type": "select",
"required": false,
"option_count": 2,
"summary": "Timing is a select control with 2 options."
}
],
"style_token_count": 15,
"style_token_map": [
{
"role": "background",
"label": "Page background",
"value": "#f7fbff",
"token_type": "color",
"summary": "Page background uses the background recipe token."
},
{
"role": "panel",
"label": "Panel surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Panel surface uses the panel recipe token."
},
{
"role": "panelElevated",
"label": "Elevated surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Elevated surface uses the panelElevated recipe token."
},
{
"role": "text",
"label": "Primary text",
"value": "#142033",
"token_type": "color",
"summary": "Primary text uses the text recipe token."
},
{
"role": "textMuted",
"label": "Muted text",
"value": "#526174",
"token_type": "color",
"summary": "Muted text uses the textMuted recipe token."
},
{
"role": "signal",
"label": "Signal accent",
"value": "#166bff",
"token_type": "color",
"summary": "Signal accent uses the signal recipe token."
},
{
"role": "uplink",
"label": "Secondary accent",
"value": "#00a6a6",
"token_type": "color",
"summary": "Secondary accent uses the uplink recipe token."
},
{
"role": "border",
"label": "Border",
"value": "#d6dee8",
"token_type": "color",
"summary": "Border uses the border recipe token."
},
{
"role": "control",
"label": "Control surface",
"value": "#ffffff",
"token_type": "color",
"summary": "Control surface uses the control recipe token."
},
{
"role": "controlText",
"label": "Control text",
"value": "#142033",
"token_type": "color",
"summary": "Control text uses the controlText recipe token."
},
{
"role": "button",
"label": "Button surface",
"value": "#166bff",
"token_type": "color",
"summary": "Button surface uses the button recipe token."
},
{
"role": "buttonText",
"label": "Button text",
"value": "#ffffff",
"token_type": "color",
"summary": "Button text uses the buttonText recipe token."
},
{
"role": "badge",
"label": "Badge surface",
"value": "#eef5ff",
"token_type": "color",
"summary": "Badge surface uses the badge recipe token."
},
{
"role": "badgeText",
"label": "Badge text",
"value": "#174ea6",
"token_type": "color",
"summary": "Badge text uses the badgeText recipe token."
},
{
"role": "fontFamily",
"label": "Font family",
"value": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
"token_type": "font",
"summary": "Font family comes from the active recipe theme tokens."
}
],
"style_token_roles": [
"background",
"panel",
"panelElevated",
"text",
"textMuted",
"signal",
"uplink",
"border",
"control",
"controlText",
"button",
"buttonText",
"badge",
"badgeText",
"fontFamily"
],
"contrast_check_count": 6,
"contrast_pass_count": 6,
"contrast_checks": [
{
"id": "text-on-background",
"label": "Text on background",
"foreground_role": "text",
"background_role": "background",
"foreground": "#142033",
"background": "#f7fbff",
"ratio": 15.73,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on background is AAA at 15.73:1 against a 4.5:1 requirement."
},
{
"id": "text-on-panel",
"label": "Text on panel",
"foreground_role": "text",
"background_role": "panel",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Text on panel is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "muted-text-on-panel",
"label": "Muted text on panel",
"foreground_role": "textMuted",
"background_role": "panel",
"foreground": "#526174",
"background": "#ffffff",
"ratio": 6.32,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Muted text on panel is AA at 6.32:1 against a 4.5:1 requirement."
},
{
"id": "button-text-on-button",
"label": "Button text on button",
"foreground_role": "buttonText",
"background_role": "button",
"foreground": "#ffffff",
"background": "#166bff",
"ratio": 4.58,
"required_ratio": 4.5,
"passes": true,
"level": "AA",
"summary": "Button text on button is AA at 4.58:1 against a 4.5:1 requirement."
},
{
"id": "control-text-on-control",
"label": "Control text on control",
"foreground_role": "controlText",
"background_role": "control",
"foreground": "#142033",
"background": "#ffffff",
"ratio": 16.35,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Control text on control is AAA at 16.35:1 against a 4.5:1 requirement."
},
{
"id": "badge-text-on-badge",
"label": "Badge text on badge",
"foreground_role": "badgeText",
"background_role": "badge",
"foreground": "#174ea6",
"background": "#eef5ff",
"ratio": 7.15,
"required_ratio": 4.5,
"passes": true,
"level": "AAA",
"summary": "Badge text on badge is AAA at 7.15:1 against a 4.5:1 requirement."
}
],
"contrast_target": "AA",
"accessibility_standard": "WCAG_2_2_AA",
"accessibility_check_count": 5,
"accessibility_checks": [
{
"id": "semantic-structure",
"label": "Semantic structure",
"category": "semantics",
"status": "covered",
"required": true,
"proof": "runtime block sections, cards, lists, and headings",
"summary": "tax-estimator keeps semantic wrappers and readable heading/copy structure in the runtime preview."
},
{
"id": "keyboard-and-tap-targets",
"label": "Keyboard and tap targets",
"category": "keyboard",
"status": "covered",
"required": true,
"proof": "mapped actions/controls render as native focusable surfaces",
"summary": "Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances."
},
{
"id": "text-alternatives",
"label": "Text alternatives",
"category": "media",
"status": "covered",
"required": false,
"proof": "media slots collapse when unused",
"summary": "Recipes without media do not leave decorative media shells that need alt text."
},
{
"id": "control-labels",
"label": "Control labels",
"category": "forms",
"status": "covered",
"required": true,
"proof": "control map includes required field labels and option metadata",
"summary": "Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review."
},
{
"id": "status-and-motion",
"label": "Status and motion",
"category": "state",
"status": "covered",
"required": true,
"proof": "runtime evidence avoids hidden status-only content",
"summary": "Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present."
}
],
"responsive_behavior_count": 3,
"responsive_behavior_map": [
{
"id": "phone",
"label": "Phone",
"viewport_width": 390,
"layout_mode": "single-column stack",
"column_count": 1,
"spacing_density": "spacious",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-phone",
"summary": "Editorial Block System stacks tax-estimator into one phone column with spacious spacing and bounded content."
},
{
"id": "tablet",
"label": "Tablet",
"viewport_width": 768,
"layout_mode": "two-column adaptive grid",
"column_count": 2,
"spacing_density": "spacious",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-tablet",
"summary": "Editorial Block System adapts tax-estimator to 2 tablet columns before expanding to the desktop layout."
},
{
"id": "desktop",
"label": "Desktop",
"viewport_width": 1366,
"layout_mode": "responsive composition grid",
"column_count": 2,
"spacing_density": "spacious",
"media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
"overflow_policy": "desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.",
"interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
"proof": "npm run test:static:block-catalog all-blocks-desktop",
"summary": "Editorial Block System gives tax-estimator up to 2 desktop columns while preserving recipe spacing."
}
],
"responsive_viewports": [
"phone",
"tablet",
"desktop"
],
"responsive_proof": [
"npm run test:static:block-catalog all-blocks-phone",
"npm run test:static:block-catalog all-blocks-tablet",
"npm run test:static:block-catalog all-blocks-desktop"
],
"interactive_roles": [
"number",
"primary",
"select"
],
"recipe_alignment": {
"action_token": "button",
"control_token": "control",
"surface_token": "panel",
"text_token": "text",
"source": "theme recipe tokens"
}
},
"cloneable": true
},
"block_order": 4
}Recipes
Every theme recipe applied to this block
Compact Ops
Dense, scannable interfaces for dashboards, configuration, and internal operations.
compactsubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Operator Product
Compact product and service-operations rhythm for B2B tools, resource hubs, and trial-interest flows.
compactsubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Polished SaaS
A calm product-marketing baseline with balanced hierarchy, spacing, and rounded controls.
comfortablesubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Polished SaaS Crisp
A tighter SaaS treatment with crisp hierarchy, restrained spacing, and clean control rhythm.
comfortablesubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Polished SaaS Growth
A roomier product-marketing recipe for conversion pages, feature launches, and trial funnels.
spaciousraised
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Polished SaaS Enterprise
A precise B2B SaaS recipe with compact density, strong readability, and restrained depth.
compactsubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Regulated Professional
Measured hierarchy, conservative spacing, and high-readability surfaces for advisory and regulated service pages.
comfortablesubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Editorial Luxury
Generous type, cinematic spacing, and understated surfaces for premium narrative pages.
spacioussubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Bold Launch
Large type, decisive rhythm, and high contrast for announcements and campaign pages.
comfortablehard
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Bold Editorial Blocks
Viewport-scale block rhythm with large editorial type, crisp radii, and expressive motion for premium brand and contact pages.
spaciousraised
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Editorial Block System
A template-ready full-page block system for duplicable landing, brand, contact, campaign, and lead-generation page sets.
spaciousraised
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Minimal Ink
Flat, sharp, restrained hierarchy for documentation, proof pages, and quiet brands.
comfortablenone
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Local Service Trust
Clear service-page rhythm for residential and local businesses with pricing, FAQs, resources, and appointment requests.
comfortablesubtle
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Tactile Service Ledger
Tactile raised panels and ledger-like rhythm for recurring services, quote funnels, memberships, and field-service notes.
comfortableraised
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Soft Neumorphic
Soft raised panels with lower visual noise for guided tools and onboarding flows.
comfortableraised
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Glass Product
Layered translucent panels for demos, product storytelling, and immersive showcases.
comfortableglass
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Retro Campaign
Chunky rhythm and nostalgic scale for playful campaigns without sacrificing contrast.
comfortablehard
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Brutalist Impact
Sharp edges, hard shadows, and assertive scale for high-emphasis conversion surfaces.
compacthard
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Neo-Brutalist Playful
High-contrast cards, chunky controls, and expressive spacing for modern playful brands.
comfortablehard
Tax planning estimator
A static estimator surface for inputs, outputs, assumptions, and review handoff.
Inputs
Filing or project size
2 units
Timing
This quarter
Outputs
Estimated range
$1,200-$2,400
Demo-only range based on local assumptions.Review needed
Human confirmation required
Final numbers require provider review.Assumptions
- Uses example content only
- No submission or stored calculation is created
This estimator is informational and does not provide binding advice, pricing, or eligibility.
Contract
Schema and registry evidence
Estimator Calculator
implemented · 0.1.0
No public prop fields are exposed for this block contract.