From 94b76e51c7bcd310b9b07d2d96472ab3bb0026f7 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 19 Aug 2026 03:30:59 +0000 Subject: [PATCH] docs: rename pages.mdx component visibility key to visibleWhen ADR-0089 makes `visibleWhen` the single canonical name for the page-component conditional-visibility key. `pages.mdx` was the last English page still spelling it `visibility` in the Components code example and the property table. The old spelling still parses and is normalized at the schema boundary, so the property-table row keeps a one-line note that `visibility` is accepted as a deprecated alias rather than going silent. Fixes #129 --- content/docs/build/interface/pages.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/build/interface/pages.mdx b/content/docs/build/interface/pages.mdx index aa0deeb..d77da55 100644 --- a/content/docs/build/interface/pages.mdx +++ b/content/docs/build/interface/pages.mdx @@ -78,7 +78,7 @@ Components are the building blocks inside regions: properties: { chartType: 'line', dataset: 'sales', dimensions: ['close_month'], values: ['revenue'] }, events: { onClick: "navigate_to('opportunity_detail', { id: $event.id })" }, - visibility: "'sales_manager' in os.user.positions", + visibleWhen: "'sales_manager' in os.user.positions", } ``` @@ -95,7 +95,7 @@ parse error since 16.0, not a silently ignored no-op. | `id` | `string` | Unique component instance id | | `properties` | `object` | Component-specific configuration | | `events` | `object` | Event handlers (action expressions) | -| `visibility` | `string` | CEL visibility predicate | +| `visibleWhen` | `string` | CEL visibility predicate — component rendered only when TRUE. (`visibility` is a deprecated alias, still accepted and normalized to `visibleWhen`.) | | `style` / `className` | — | Ad-hoc CSS | | `responsiveStyles` | `object` | **Preferred** styling channel: desktop-first per-breakpoint style maps (`large` base, then `medium` / `small` / `xsmall` overrides), compiled to scoped CSS — prefer design tokens like `var(--space-8)` |