astryx-dracula 0.5.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/BRAND.md +57 -6
  2. package/README.md +16 -6
  3. package/USAGE.md +50 -50
  4. package/astryx-dracula.d.ts +2 -2
  5. package/astryx-dracula.js +49 -11
  6. package/astryx-dracula.variants.d.ts +2 -2
  7. package/icons.mjs +4 -0
  8. package/icons.tsx +8 -0
  9. package/package.json +23 -18
  10. package/shared/auth-chrome-config.ts +0 -4
  11. package/shared/auth-chrome.tsx +2 -3
  12. package/shared/chaptered-doc-config.ts +3 -2
  13. package/shared/chaptered-doc.tsx +1 -2
  14. package/shared/chart-hues.ts +21 -6
  15. package/shared/chart-legend.tsx +2 -2
  16. package/shared/data-bar.tsx +2 -2
  17. package/shared/order-desk.tsx +52 -54
  18. package/shared/revenue-chart.tsx +1 -1
  19. package/shared/scene-castle.tsx +21 -13
  20. package/shared/settings-data.ts +0 -6
  21. package/shared/settings-rows.tsx +1 -23
  22. package/templates/ai-chat-landing.template.mjs +1 -0
  23. package/templates/ai-chat-landing.tsx +30 -11
  24. package/templates/ai-chat.template.mjs +1 -0
  25. package/templates/ai-chat.tsx +9 -3
  26. package/templates/blank.template.mjs +1 -0
  27. package/templates/blank.tsx +4 -2
  28. package/templates/centered-hero.template.mjs +1 -0
  29. package/templates/centered-hero.tsx +5 -3
  30. package/templates/classic-gallery.template.mjs +1 -0
  31. package/templates/classic-gallery.tsx +9 -2
  32. package/templates/contact-form.template.mjs +1 -0
  33. package/templates/contact-form.tsx +13 -2
  34. package/templates/dashboard-portfolio.template.mjs +1 -0
  35. package/templates/dashboard-portfolio.tsx +21 -6
  36. package/templates/dashboard.template.mjs +1 -0
  37. package/templates/dashboard.tsx +9 -7
  38. package/templates/detail-page.template.mjs +1 -0
  39. package/templates/detail-page.tsx +28 -36
  40. package/templates/documentation-design.template.mjs +1 -0
  41. package/templates/documentation-design.tsx +8 -3
  42. package/templates/documentation-technical.template.mjs +1 -0
  43. package/templates/documentation-technical.tsx +11 -6
  44. package/templates/documentation.template.mjs +1 -0
  45. package/templates/documentation.tsx +16 -7
  46. package/templates/editor.template.mjs +1 -0
  47. package/templates/editor.tsx +4 -2
  48. package/templates/file-explorer.template.mjs +1 -0
  49. package/templates/file-explorer.tsx +4 -2
  50. package/templates/form-two-column.template.mjs +1 -0
  51. package/templates/form-two-column.tsx +19 -4
  52. package/templates/form-wizard.template.mjs +15 -0
  53. package/templates/form-wizard.tsx +878 -0
  54. package/templates/gallery-hero.template.mjs +1 -0
  55. package/templates/gallery-hero.tsx +14 -6
  56. package/templates/ide.template.mjs +1 -0
  57. package/templates/ide.tsx +187 -101
  58. package/templates/incident-console.template.mjs +1 -0
  59. package/templates/incident-console.tsx +137 -85
  60. package/templates/kanban-board.template.mjs +1 -0
  61. package/templates/kanban-board.tsx +51 -7
  62. package/templates/library.template.mjs +1 -0
  63. package/templates/library.tsx +15 -4
  64. package/templates/login-card.template.mjs +1 -0
  65. package/templates/login-card.tsx +4 -2
  66. package/templates/login-split.template.mjs +1 -0
  67. package/templates/login-split.tsx +8 -5
  68. package/templates/login-sso.template.mjs +1 -0
  69. package/templates/login-sso.tsx +13 -19
  70. package/templates/login.template.mjs +1 -0
  71. package/templates/login.tsx +4 -2
  72. package/templates/messaging-shell.template.mjs +1 -0
  73. package/templates/messaging-shell.tsx +114 -47
  74. package/templates/mixed-gallery.template.mjs +1 -0
  75. package/templates/mixed-gallery.tsx +10 -2
  76. package/templates/payment-form.template.mjs +1 -0
  77. package/templates/payment-form.tsx +34 -31
  78. package/templates/product-detail.template.mjs +1 -0
  79. package/templates/product-detail.tsx +21 -5
  80. package/templates/product-gallery.template.mjs +1 -0
  81. package/templates/product-gallery.tsx +12 -5
  82. package/templates/product-tour.template.mjs +1 -0
  83. package/templates/product-tour.tsx +21 -14
  84. package/templates/settings-dialog.template.mjs +1 -0
  85. package/templates/settings-dialog.tsx +10 -3
  86. package/templates/settings-sidebar.template.mjs +1 -0
  87. package/templates/settings-sidebar.tsx +609 -588
  88. package/templates/settings.template.mjs +1 -0
  89. package/templates/settings.tsx +11 -12
  90. package/templates/shell-nav.template.mjs +1 -0
  91. package/templates/shell-nav.tsx +47 -29
  92. package/templates/shell-side-nav.template.mjs +1 -0
  93. package/templates/shell-side-nav.tsx +88 -70
  94. package/templates/shell-top-nav.template.mjs +1 -0
  95. package/templates/shell-top-nav.tsx +102 -88
  96. package/templates/side-gallery.template.mjs +1 -0
  97. package/templates/side-gallery.tsx +4 -2
  98. package/templates/table-grouped.template.mjs +1 -0
  99. package/templates/table-grouped.tsx +150 -134
  100. package/templates/table-page-chart.template.mjs +1 -0
  101. package/templates/table-page-chart.tsx +4 -2
  102. package/templates/table-page-heatmap-status.template.mjs +1 -0
  103. package/templates/table-page-heatmap-status.tsx +4 -2
  104. package/templates/{table-page-shoe-store-heatmap.template.mjs → table-page-shoe-store.template.mjs} +1 -0
  105. package/templates/{table-page-shoe-store-heatmap.tsx → table-page-shoe-store.tsx} +5 -3
  106. package/templates/table-page.template.mjs +1 -0
  107. package/templates/table-page.tsx +12 -2
  108. package/templates/table-tree.template.mjs +16 -0
  109. package/templates/table-tree.tsx +707 -0
  110. package/templates/table.template.mjs +1 -0
  111. package/templates/table.tsx +4 -2
  112. package/templates/tech-report.template.mjs +1 -0
  113. package/templates/tech-report.tsx +18 -13
  114. package/templates/theme-showcase.template.mjs +1 -0
  115. package/templates/theme-showcase.tsx +41 -28
  116. package/templates/work-item-detail.template.mjs +8 -0
  117. package/templates/work-item-detail.tsx +1049 -0
  118. package/theme.css +71 -78
  119. package/theme.css.d.ts +9 -0
  120. package/tokens.css +79 -46
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > LC[p=0] > Ctr > V[g=8] > ((Ctr > S.transparent > V[g=4 a=center] > (V[g=2 a=center] > Hd"Hung after dark"[level=1] + Tx"A coven-curated wall"[t=body]) + (TL > Tab"All"! + Tab"Lifestyle" + Tab"Scenery" + Tab"Home") + Tx"10 pieces on the wall"[t=body]) + (G[c={min:260} g=4] > (C[p=0] > AR[ratio=3/2])*10))
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill] > LC[p=0] > Ctr > V[g=8] > ((Ctr > S.transparent[p=0 mw=680] > V[g=4 a=center] > (V[g=2 a=center] > Hd"Hung after dark"[level=1] + Tx"A coven-curated wall"[t=body]) + (TL > Tab"All"! + Tab"Lifestyle" + Tab"Scenery" + Tab"Home") + Tx"10 pieces on the wall"[t=body]) + (G[c={min:260} g=4] > (C[p=0] > AR[ratio=3/2] > Scene{SceneTile})*10))
4
6
 
5
7
  import { AspectRatio } from "@astryxdesign/core/AspectRatio";
6
8
  import { Card } from "@astryxdesign/core/Card";
@@ -29,6 +31,10 @@ const frameClip: CSSProperties = {
29
31
  const textCenter: CSSProperties = {
30
32
  textAlign: "center",
31
33
  };
34
+ // Definite ancestor for `Layout height="fill"`: 100dvh, not minHeight: '100%'
35
+ // (a percentage min-height against an indefinite block computes to 0 — CSS 2.1
36
+ // 10.5). Same shape as side-gallery.tsx.
37
+ const pageStyle: CSSProperties = { height: "100dvh" };
32
38
 
33
39
  // ─── Gallery Data ───────────────────────────────────────────────────────────
34
40
 
@@ -78,6 +84,7 @@ export default function ClassicGallery() {
78
84
 
79
85
  return (
80
86
  <Layout
87
+ style={pageStyle}
81
88
  height="fill"
82
89
  content={
83
90
  <LayoutContent padding={0}>
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Contact Form",
4
4
  description: "Lead capture form with goals and budget",
5
+ keywords: ["contact", "form", "enquiry", "get in touch", "support", "message"],
5
6
  category: "forms",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // Ctr > V[a=center] > S.transparent[p=6] > V[g=6] > (V[g=2 a=center] > Hd"Let's brew after dark"[level=1] + Tx"Tell us a bit"[t=body]) + (V[g=4] > Hd"Why work with us"[level=2] + (G[c={min:200} g=4] > (C > V[g=3] > Ic + (V[g=1] > Hd"Title"[level=3] + Tx"Desc"[t=body]))*3)) + (V[g=4] > Hd"Your details"[level=2] + (G[c={min:260} g=4] > TI"Full name" + TI"Email") + (G[c={min:260} g=4] > TI"Company" + TI"Phone")) + D + (V[g=4] > Hd"Your project"[level=2] + (Fd"Goals"[req] > (H[g=2] > Tk"Goal"*10)) + SE"Timeline" + SE"Budget" + (RL"Source" > RLI*5) + TA"Notes" + CB"Decision maker") + (V[g=3] > B.primary"Send it into the night" + (Tx[t=supporting] > Lk"Privacy Policy"))
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // Ctr > V[a=center] > S.transparent[p=6] > V[g=6] > (V[g=2 a=center] > Hd"Let's brew after dark"[level=1 t=display-2] + Tx"Tell us a bit"[t=body]) + (V[g=4] > Hd"Why work with us"[level=2] + (G[c={min:200} g=4] > (C > V[g=3] > Ic + (V[g=1] > Hd"Title"[level=3] + Tx"Desc"[t=body]))*3)) + (V[g=4] > Hd"Your details"[level=2] + (G[c={min:260} g=4] > TI"Full name"[req] + TI"Email"[req]) + (G[c={min:260} g=4] > TI"Company"[req] + TI"Phone"[req])) + D + (V[g=4] > Hd"Your project"[level=2] + (Fd"What are you going for?"[req] > (H[g=2] > Tk"Goal"*10)) + SE{Selector}"When are you thinking?" + SE{Selector}"Ballpark budget?" + (RL"How did you hear about us?" > RLI*5) + TA"Anything else?" + CB"I'm a budget decision-maker") + (V[g=3] > B.primary"Send it into the night" + (Tx[t=supporting] > Lk"Privacy Policy"))
4
6
 
5
7
  import { Button } from "@astryxdesign/core/Button";
6
8
  import { Card } from "@astryxdesign/core/Card";
@@ -144,6 +146,7 @@ export default function ContactForm() {
144
146
  label="Full name"
145
147
  isRequired
146
148
  placeholder="Full name"
149
+ autoComplete="name"
147
150
  value={fullName}
148
151
  onChange={setFullName}
149
152
  status={errors.fullName ? { type: "error", message: errors.fullName } : undefined}
@@ -151,7 +154,9 @@ export default function ContactForm() {
151
154
  <TextInput
152
155
  label="Email"
153
156
  isRequired
157
+ type="email"
154
158
  placeholder="you@company.com"
159
+ autoComplete="email"
155
160
  value={email}
156
161
  onChange={setEmail}
157
162
  status={errors.email ? { type: "error", message: errors.email } : undefined}
@@ -162,6 +167,7 @@ export default function ContactForm() {
162
167
  label="Company"
163
168
  isRequired
164
169
  placeholder="Company"
170
+ autoComplete="organization"
165
171
  value={company}
166
172
  onChange={setCompany}
167
173
  status={errors.company ? { type: "error", message: errors.company } : undefined}
@@ -169,7 +175,9 @@ export default function ContactForm() {
169
175
  <TextInput
170
176
  label="Phone"
171
177
  isRequired
178
+ type="tel"
172
179
  placeholder="Phone number"
180
+ autoComplete="tel"
173
181
  value={phone}
174
182
  onChange={setPhone}
175
183
  status={errors.phone ? { type: "error", message: errors.phone } : undefined}
@@ -188,6 +196,9 @@ export default function ContactForm() {
188
196
  labelID="campaign-goals-label"
189
197
  isGroupLabel
190
198
  isRequired
199
+ // The token row is a custom, non-bordered control, so the
200
+ // message box must sit below it (attached overlaps the input).
201
+ statusVariant="detached"
191
202
  status={errors.goals ? { type: "error", message: errors.goals } : undefined}
192
203
  >
193
204
  <HStack gap={2} wrap="wrap" role="group" aria-labelledby="campaign-goals-label">
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Portfolio Dashboard",
4
4
  description: "Holdings chart, market cards, and trending table",
5
+ keywords: ["portfolio", "holdings", "wealth", "investment", "positions", "dashboard"],
5
6
  category: "dashboard",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L[h=fill] > LC[p=6] > V[g=6] > (H[j=between a=center] > Hd"The night vault"[level=1] + Tx"1 year"[t=body]) + (G[c={min:280} g=4] > (C > V[g=2] > Tx"Total value"[t=supporting] + (H[g=2] > Tx"$294,200"[t=display-3] + Tx"+14.8%"[t=body]))*4) + (G[c={min:280} g=4] > (C > V[g=4] > (H[j=between] > Hd"Vault value"[level=2] + Lk"View details") + (C > V[g=3] > Tx"Weekly closes"[t=supporting])) + (V[g=4] > (H[j=between] > Hd"Top holdings"[level=2] + Lk"View all") + UL)) + D + (H[j=between a=start] > (V[g=1] > Hd"Market at midnight"[level=2] + Tx"Past 24 hours under moonlight"[t=body]) + B"View more") + (G[c={min:280} g=4] > (C > V[g=3] > Hd"Index"[level=3] + Tx"$5,200"[t=body])*8) + (C > V[g=4] > Hd"Trending stocks"[level=3] + T)
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill] > LC[p=6] > V[g=6] > (H[j=between a=center] > Hd"The night vault"[level=1] + Tx"1 year"[t=body]) + (G[c={min:280} g=4] > (C > V[g=2] > Tx"Total value"[t=supporting] + (H[g=2 a=center] > Tx"$294,200"[t=display-3] + (H[g=1 a=center] > Ic + Tx"+14.8%"[t=body])) + Tx"Weekly closes · trailing 12 months"[t=supporting])*4) + (G[c={min:280} g=4] > (C > V[g=4] > (H[j=between a=center] > Hd"Vault value"[level=2] + Lk"View details") + (V[g=3] > C[p=4] + Tx"Weekly closes · trailing 12 months"[t=supporting])) + (V[g=4] > (H[j=between a=center] > Hd"Top holdings"[level=2] + Lk"View all") + (UL[density=spacious] > LI*5))) + D + (H[j=between a=start] > (V[g=1] > Hd"Market at midnight"[level=2] + Tx"Past 24 hours under moonlight"[t=body]) + B.secondary"View more") + (G[c={min:280} g=4] > (C > V[g=4] > (V[g=0] > Hd"Dow Jones"[level=3] + Tx"DJI"[t=supporting]) + Spl + (H[g=3 a=center] > Tx"43,821.67"[t=display-3] + (H[g=1 a=center] > Ic + Tx"+0.42%"[t=body])))*8) + (C > V[g=6] > (H[j=between a=center] > Hd"Trending stocks"[level=3]) + T[hover density=compact dv=rows])
4
6
 
5
7
  import { Avatar } from "@astryxdesign/core/Avatar";
6
8
  import { Button } from "@astryxdesign/core/Button";
@@ -16,11 +18,13 @@ import { List, ListItem } from "@astryxdesign/core/List";
16
18
  import type { PixelWidth, TableColumn } from "@astryxdesign/core/Table";
17
19
  import { pixel, proportional } from "@astryxdesign/core/Table";
18
20
  import { Heading, Text } from "@astryxdesign/core/Text";
21
+ import { CHART_HUES } from "astryx-dracula/shared/chart-hues";
19
22
  import { ChartLabel } from "astryx-dracula/shared/chart-labels";
20
23
  import { CHART_PANEL_STYLE } from "astryx-dracula/shared/chart-panel-style";
21
24
  import { MetricCard, TableCard } from "astryx-dracula/shared/metric-card";
22
25
  import { MetricDelta } from "astryx-dracula/shared/metric-delta";
23
26
  import { Sparkline, type SparkPoint } from "astryx-dracula/shared/sparkline";
27
+ import type { CSSProperties } from "react";
24
28
 
25
29
  // ============= DATA =============
26
30
 
@@ -528,6 +532,10 @@ const PORTFOLIO_STEP = PORTFOLIO_WIDTH / portfolioBars.length;
528
532
  const portfolioYFor = (v: number) =>
529
533
  PORTFOLIO_BASE - ((v - PORTFOLIO_MIN) / (PORTFOLIO_MAX - PORTFOLIO_MIN)) * PORTFOLIO_PLOT;
530
534
  const PORTFOLIO_Y_TICKS = [200000, 240000, 280000, 320000];
535
+ // The chart annotates its own last point. Reading it from the series rather
536
+ // than restating the anchor keeps the label true when the generator's noise
537
+ // moves the closing value off the 294,200 anchor it is interpolated toward.
538
+ const PORTFOLIO_LAST = portfolioData[portfolioData.length - 1].value;
531
539
 
532
540
  function PortfolioChart() {
533
541
  return (
@@ -546,7 +554,7 @@ function PortfolioChart() {
546
554
  y1={portfolioYFor(t)}
547
555
  x2={PORTFOLIO_LEFT + PORTFOLIO_WIDTH}
548
556
  y2={portfolioYFor(t)}
549
- stroke="var(--color-separator)"
557
+ stroke="var(--color-graph-gridlines)"
550
558
  strokeDasharray="3 3"
551
559
  opacity={0.5}
552
560
  />
@@ -565,7 +573,7 @@ function PortfolioChart() {
565
573
  width={Math.max(2, PORTFOLIO_STEP - 2)}
566
574
  height={h}
567
575
  rx={4}
568
- fill="var(--dracula-green)"
576
+ fill={CHART_HUES.green}
569
577
  />
570
578
  );
571
579
  })}
@@ -581,11 +589,11 @@ function PortfolioChart() {
581
589
  ))}
582
590
  <ChartLabel
583
591
  x={PORTFOLIO_LEFT + PORTFOLIO_WIDTH - 4}
584
- y={portfolioYFor(294200) - 8}
592
+ y={portfolioYFor(PORTFOLIO_LAST) - 8}
585
593
  textAnchor="end"
586
594
  fill="var(--color-text-highlight)"
587
595
  >
588
- $294k
596
+ ${Math.round(PORTFOLIO_LAST / 1000)}k
589
597
  </ChartLabel>
590
598
  </svg>
591
599
  </Card>
@@ -730,11 +738,18 @@ function AssetRow({
730
738
  );
731
739
  }
732
740
 
741
+ // A definite ancestor for `Layout height="fill"`. 100dvh, not minHeight: '100%':
742
+ // a percentage min-height against an indefinite containing block computes to 0
743
+ // (CSS 2.1 10.5), so the document would keep the scroll instead of the content
744
+ // pane. Same shape as dashboard.tsx and heatmap-status.
745
+ const pageStyle: CSSProperties = { height: "100dvh" };
746
+
733
747
  // ============= MAIN COMPONENT =============
734
748
 
735
749
  export default function DashboardPortfolio() {
736
750
  return (
737
751
  <Layout
752
+ style={pageStyle}
738
753
  height="fill"
739
754
  content={
740
755
  <LayoutContent padding={6}>
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Analytics Dashboard",
4
4
  description: "KPI cards, SVG chart strips, and data tables",
5
+ keywords: ["dashboard", "analytics", "kpi", "metrics", "charts", "overview"],
5
6
  category: "dashboard",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > LC[p=6] > V[g=6] > (Hd"The night shift"[level=1] + V[g=6] > (H[j=between a=center] > Hd"Awake after dark"[level=2] + B.secondary"Reload") + (V[g=3] > C[p=4] + Tx"Hourly intervals"[t=supporting] + (H[g=6] > (H[g=2 a=center] > Ic + Tx"Desktop"[t=supporting])*2))) + (G[c={min:280} g=4] > (C > V[g=2] > Tx"Moonlit visitors"[t=supporting] + (H[g=2] > Tx"27.3 k"[t=display-3] + Tx"+18.2%"[t=body]) + Tx"Last 30 days vs. Previous"[t=supporting])*4) + D + (H[j=between a=center] > Hd"Night denizens"[level=2] + B.secondary"View more") + (G[c={min:280} g=4] > (C > V[g=4] > Hd"Territory"[level=3] + (H[g=4 wrap] > (V[g=0] > (H[g=2 a=center] > Ic + Tx[t=supporting]) + Tx[t=supporting])*5))*2) + D + (H[j=between a=center] > Hd"Engagement"[level=2] + B.secondary"View more") + (G[c={min:280} g=4] > (C > V[g=6] > (H[j=between a=center] > Hd"Top pages"[level=3] + Lk"All pages") + T)*2)
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill] > LC[p=6] > V[g=6] > (Hd"The night shift"[level=1] + V[g=6] > (H[j=between a=center] > Hd"Awake after dark"[level=2] + B.secondary"Reload") + (V[g=3] > C[p=4] + (V[g=1] > (H[g=4 a=center] > (H[g=1 a=center] > Sw + Tx"Desktop"[t=supporting])*2) + Tx"Hourly intervals"[t=supporting]))) + (G[c={min:280} g=4] > (C > V[g=2] > Tx"Moonlit visitors"[t=supporting] + (H[g=2 a=center] > Tx"27.3 k"[t=display-3] + (H[g=1 a=center] > Ic + Tx"+18.2%"[t=body])) + Tx"Last 30 days vs. Previous"[t=supporting] + Spl)*4) + D + (H[j=between a=center] > Hd"Night denizens"[level=2] + B.secondary"View more") + (G[c={min:280} g=4] > (C > V[g=4] > Hd"Territory"[level=3] + (H[g=4 wrap] > (V[g=1] > (H[g=2 a=center] > Ic + Tx[t=supporting]) + Tx[t=supporting])*5))*2) + D + (H[j=between a=center] > Hd"Engagement"[level=2] + B.secondary"View more") + (G[c={min:280} g=4] > (C > V[g=6] > (H[j=between a=center] > Hd"Top pages"[level=3] + Lk"All pages") + T[hover density=compact dv=rows])*2)
4
6
 
5
7
  /**
6
8
  * Analytics Dashboard — the night shift at a glance: live active users, four KPI tiles, audience breakdown strips, and engagement tables. (Frame/responsive/container: see XLE header above.)
@@ -23,7 +25,7 @@ const SELF_HASH = "#/templates/dashboard";
23
25
 
24
26
  // ============= ICONS =============
25
27
 
26
- import { CHART_HUES } from "astryx-dracula/shared/chart-hues";
28
+ import { CHART_HUES, type DataColor } from "astryx-dracula/shared/chart-hues";
27
29
  import { ChartLegend } from "astryx-dracula/shared/chart-legend";
28
30
  import { CHART_PANEL_STYLE } from "astryx-dracula/shared/chart-panel-style";
29
31
  import { BarCell, CountCell, MetricCard, TableCard } from "astryx-dracula/shared/metric-card";
@@ -458,7 +460,7 @@ function ActiveUsersChart() {
458
460
  y1="30"
459
461
  x2="520"
460
462
  y2="30"
461
- stroke="var(--color-separator)"
463
+ stroke="var(--color-graph-gridlines)"
462
464
  strokeDasharray="3 3"
463
465
  opacity={0.5}
464
466
  />
@@ -467,11 +469,11 @@ function ActiveUsersChart() {
467
469
  y1="80"
468
470
  x2="520"
469
471
  y2="80"
470
- stroke="var(--color-separator)"
472
+ stroke="var(--color-graph-gridlines)"
471
473
  strokeDasharray="3 3"
472
474
  opacity={0.5}
473
475
  />
474
- <line x1="20" y1="130" x2="520" y2="130" stroke="var(--color-separator)" />
476
+ <line x1="20" y1="130" x2="520" y2="130" stroke="var(--color-graph-gridlines)" />
475
477
  {bars.map((d, i) => {
476
478
  const hAll = (d.allUsers / max) * 110;
477
479
  const hDesktop = (d.desktop / max) * 110;
@@ -546,7 +548,7 @@ function StackedBarCard({
546
548
  data,
547
549
  }: {
548
550
  title: string;
549
- data: Array<{ label: string; value: number; color: string }>;
551
+ data: Array<{ label: string; value: number; color: DataColor }>;
550
552
  }) {
551
553
  const total = data.reduce((sum, d) => sum + d.value, 0);
552
554
  const clipId = `stacked-${title.toLowerCase().replace(/[^a-z]+/g, "-")}`;
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Order Detail",
4
4
  description: "Items, invoice, timeline, and side panel",
5
+ keywords: ["detail", "order", "invoice", "product", "purchase", "receipt", "transaction"],
5
6
  category: "commerce",
6
7
  };
@@ -1,9 +1,12 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > (LH[divider] > V[g=3] > ((H[g=4 a=start] > (SI > V[g=0] > (Lk"All orders" + (V[g=0] > Hd"#1001"[level=1] + (H[g=1 a=center] > Tx"5 ordered items"[t=supporting] + Av"Vlad Dracul" + SD"Unfulfilled" + Tx"02/23/2026"[t=supporting] + Lk"See all")))) + (H[g=2] > B"Restock" + B"Edit")) + (H[g=3 a=center] > (SI > TL > Tab"Details"! + Tab"Invoices" + Tab"Timeline" + TabMenu"More") + B.ghost))) + (LC > V[g=4] > ((S > V[g=4] > ((H[g=2 a=center] > Hd"Items"[level=2] + SD"Unfulfilled") + UL)) + (S > V[g=4] > ((H[g=2 a=center] > Hd"Invoice"[level=2] + SD"Paid") + ML)) + (S > V[g=4] > ((H[g=2 a=center] > Hd"Timeline"[level=2] + B.ghost) + UL)))) + (LP[w=320 p=4] > V[g=4] > Col"Notes" + Col"Customer" + Col"Fraud analysis")
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill mw=1000] > (LH[divider p=6 pb=0] > V[g=3] > ((H[g=4 a=start] > (SI[fill] > V[g=2] > (Lk"All orders" + (V[g=0] > Hd"#1001"[level=1] + (H[g=1 a=center wrap] > Tx"5 ordered items"[t=supporting] + (H[g=1 a=center] > Bu + Av"Vlad Dracul" + Tx"Vlad Dracul"[t=supporting]) + (H[g=1 a=center] > Bu + SD"Unfulfilled" + Tx"Unfulfilled"[t=supporting]) + (H[g=1 a=center] > Bu + Ic + Tx"02/23/2026"[t=supporting]) + (H[g=1 a=center] > Bu + Ic + Tx"Needs attention"[t=supporting]) + (H[g=1 a=center] > Bu + Lk"See all")))) + (H[g=2] > B.secondary"Restock" + B.secondary"Edit")) + (H[g=2] > (SI[fill] > V[a=stretch] > B.secondary"Restock") + (SI[fill] > V[a=stretch] > B.secondary"Edit")) + (H[a=center] > (SI[fill] > TL[size=lg fullBleed] > (Tab"Details"! + Tab"Invoices" + Tab"Timeline" + TabMenu"More")) + B.ghost))) + (LC > V[g=4] > ((S > V[g=4] > ((H[g=2 a=center wrap] > (SI[fill] > (H[g=2 a=center] > Hd"Items"[level=2] + SD"Unfulfilled" + Tx"Unfulfilled"[t=supporting])) + (H[g=2] > B.ghost"Fulfill item" + B.secondary"Create label")) + (UL[density=spacious edge=outset] > LI*5)) + (S > V[g=4] > ((H[g=2 a=center wrap] > (SI[fill] > (H[g=2 a=center] > Hd"Invoice"[level=2] + SD"Paid" + Tx"Paid"[t=supporting])) + (H[g=2] > B.ghost"Refund" + B.secondary"Send Invoice")) + (ML > MLI*5) + D + (ML > MLI*1))) + (S > V[g=4] > ((H[g=2 a=center] > (SI[fill] > Hd"Timeline"[level=2]) + B.ghost"Filters") + (UL[density=spacious edge=outset] > LI*4)))) + (LP[w=320 p=4] > V[g=4] > Col"Notes" + Col"Customer" + Col"Fraud analysis")) ;; Dlg[variant=fullscreen] > L[h=auto] > (DH"Order details" + (LC[p=4] > V[g=4] > Col"Notes" + Col"Customer" + Col"Fraud analysis"))
4
6
 
5
7
  import { Avatar } from "@astryxdesign/core/Avatar";
6
8
  import { Button } from "@astryxdesign/core/Button";
9
+ import { Center } from "@astryxdesign/core/Center";
7
10
  import { Collapsible } from "@astryxdesign/core/Collapsible";
8
11
  import { Dialog, DialogHeader } from "@astryxdesign/core/Dialog";
9
12
  import { Divider } from "@astryxdesign/core/Divider";
@@ -41,25 +44,20 @@ import {
41
44
  } from "lucide-react";
42
45
  // ─── Styles ─────────────────────────────────────────────────────────────────
43
46
  import type { CSSProperties } from "react";
44
- import { useState } from "react";
45
47
 
46
- // The only custom CSS in this template is small optical-alignment negative
47
- // margins: LayoutHeader/TabList have no edge-dock prop (#2622) and List
48
- // has no "bleed to container edge" prop (#2626). Everything else uses props.
49
- // Plain inline styles — no StyleX compiler required.
48
+ // Definite ancestor for `height="fill"`: 100dvh, not minHeight: '100%' (a
49
+ // percentage min-height against an indefinite block computes to 0 — CSS 2.1
50
+ // 10.5). Templates ship standalone, so the page owns this, not the host.
51
+ const pageStyle: CSSProperties = { height: "100dvh" };
50
52
 
51
- // Bleed the tab bar to the header's content edges so the active-tab underline
52
- // meets the header divider. No edge-dock prop on TabList (#2622).
53
- const tabsRow: CSSProperties = {
54
- marginInline: -12,
55
- marginBottom: -16,
56
- marginTop: 12,
57
- };
58
- // Pull the list items' inner padding back so their content optically aligns
59
- // with the section heading above (ListItem insets content by ~8px). No
60
- // edge/inset prop on List (#2626).
61
- const itemsList: CSSProperties = {
62
- marginInline: -8,
53
+ import { useState } from "react";
54
+
55
+ // The only custom CSS in this template is the sigil plate's shrink rule: the
56
+ // List row supplies the box, and the plate must not squash beside a long name.
57
+ // Everything else uses props.
58
+ const sigilClip: CSSProperties = {
59
+ flexShrink: 0,
60
+ overflow: "clip",
63
61
  };
64
62
 
65
63
  // ─── Product data ───────────────────────────────────────────────────────────
@@ -111,17 +109,10 @@ const PRODUCT_HUES: readonly SceneHue[] = [
111
109
  "var(--dracula-green)",
112
110
  ];
113
111
 
114
- const sigilClip: CSSProperties = {
115
- width: 40,
116
- height: 40,
117
- overflow: "clip",
118
- flexShrink: 0,
119
- };
120
-
121
112
  function ProductSigil({ index }: { name: string; index: number }) {
122
113
  const hue = PRODUCT_HUES[index % PRODUCT_HUES.length];
123
114
  return (
124
- <div style={sigilClip}>
115
+ <Center width={40} height={40} style={sigilClip}>
125
116
  <SceneFrame
126
117
  label={`${PRODUCTS[index % PRODUCTS.length].name} sigil`}
127
118
  viewBox="0 0 40 40"
@@ -132,7 +123,7 @@ function ProductSigil({ index }: { name: string; index: number }) {
132
123
  <circle cx={25} cy={9} r={5.5} fill="var(--dracula-bg-light)" opacity={0.5} />
133
124
  <path d="M0 28 Q10 22 20 26 T40 24 V40 H0 Z" fill="var(--dracula-current-line)" />
134
125
  </SceneFrame>
135
- </div>
126
+ </Center>
136
127
  );
137
128
  }
138
129
 
@@ -199,7 +190,7 @@ function PageHeader({
199
190
  isNarrow: boolean;
200
191
  }) {
201
192
  return (
202
- <LayoutHeader hasDivider padding={6}>
193
+ <LayoutHeader hasDivider padding={6} paddingBlockEnd={0}>
203
194
  <VStack gap={3}>
204
195
  <HStack gap={4} vAlign="start">
205
196
  <StackItem size="fill">
@@ -284,9 +275,9 @@ function PageHeader({
284
275
  </HStack>
285
276
  )}
286
277
 
287
- <HStack vAlign="center" style={tabsRow}>
278
+ <HStack vAlign="center">
288
279
  <StackItem size="fill">
289
- <TabList value={activeTab} onChange={onTabChange} size="lg">
280
+ <TabList value={activeTab} onChange={onTabChange} size="lg" isFullBleed>
290
281
  <Tab value="details" label="Details" />
291
282
  <Tab value="invoices" label="Invoices" />
292
283
  <Tab value="timeline" label="Timeline" />
@@ -334,7 +325,7 @@ function ItemsCard() {
334
325
  </HStack>
335
326
  </HStack>
336
327
 
337
- <List density="spacious" style={itemsList}>
328
+ <List density="spacious" edge="outset">
338
329
  {PRODUCTS.map((product, i) => (
339
330
  <ListItem
340
331
  key={product.name}
@@ -482,7 +473,7 @@ function TimelineSection() {
482
473
  <Button label="Filters" variant="ghost" icon={<Icon icon={Filter} />} isIconOnly />
483
474
  </HStack>
484
475
 
485
- <List density="spacious" style={itemsList}>
476
+ <List density="spacious" edge="outset">
486
477
  {ACTIVITY.map((item) => (
487
478
  <ListItem
488
479
  key={`${item.user}-${item.time}`}
@@ -601,6 +592,7 @@ export default function DetailPage() {
601
592
  return (
602
593
  <>
603
594
  <Layout
595
+ style={pageStyle}
604
596
  height="fill"
605
597
  contentWidth={1000}
606
598
  defaultHasDividers
@@ -624,9 +616,9 @@ export default function DetailPage() {
624
616
  }
625
617
  end={!isNarrow && showSidePanel ? <RightPanel /> : undefined}
626
618
  />
627
- {/* Mobile: the side panel content opens as a full-screen dialog. (A
628
- side drawer/sheet would be more idiomatic, but Astryx has no Drawer
629
- component yet — #2575 — so we use the fullscreen Dialog variant.) */}
619
+ {/* Mobile: the side-panel content uses the full viewport so order details
620
+ are not squeezed beside narrow page chrome. Drawer remains available
621
+ for side-overlay flows that intentionally preserve page context. */}
630
622
  <Dialog
631
623
  variant="fullscreen"
632
624
  isOpen={isNarrow && isPanelDialogOpen}
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Design Documentation",
4
4
  description: "Live preview, usage guide, and code examples",
5
+ keywords: ["documentation", "docs", "design system", "reference", "guide", "spec"],
5
6
  category: "docs",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > (LC > V[g=8] > (V[g=2] > Hd"Button"[level=1] + Tx"March 30, 2026"[t=supporting]) + (C.muted[p=0] > Ctr[h=360]) + (V[g=4] > Hd"Usage"[level=2] + Tx"Usage"[t=body] + Hd"Best practices"[level=3] + T) + D + (V[g=4] > Hd"Examples"[level=2] + Tx"Explore"[t=body]) + (V[g=8] > (C[p=0] > (S[p=3] > Tx"Semantics"[t=body]) + Ctr[h=280] + (S.muted[p=3] > V[g=3] > (TL > Tab"Description"! + Tab"Code") + Tx"We have four"[t=body])) + (C[p=0] > (S[p=3] > Tx"Default button with badge"[t=body]) + Ctr[h=280] + (S.muted[p=3] > V[g=3] > (TL > Tab"Description"! + Tab"Code") + Tx"Buttons can include"[t=body])))) + (LP > Outline)
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=auto mw=960] > (LC[p=8 !scroll] > V[g=8] > (V[g=2] > Hd"Button"[level=1 t=display-2] + Tx"March 30, 2026"[t=supporting] + SE{Selector}"On this page") + (C.muted[p=0] > Ctr[h=360]) + (V[g=4] > Hd"Usage"[level=2] + Tx"Usage"[t=body] + Hd"Best practices"[level=3] + T[hover density=spacious]) + D + (V[g=4] > Hd"Examples"[level=2] + Tx"Explore"[t=body]) + (V[g=8] > (C[p=0] > (S.transparent[p=3] > Tx"Semantics"[t=body]) + Ctr[h=280] + (S.muted[p=3 dv=[top]] > V[g=3] > (TL[size=sm] > (Tab"Description"! + Tab"Code")) + Tx"We have four"[t=body])) + (C[p=0] > (S.transparent[p=3] > Tx"Default button with badge"[t=body]) + Ctr[h=280] + (S.muted[p=3 dv=[top]] > V[g=3] > (TL[size=sm] > (Tab"Description"! + Tab"Code")) + Tx"Buttons can include"[t=body])))) + (LP[!scroll] > Outline)
4
6
 
5
7
  /**
6
8
  * Documentation detail — one component, its usage, its guidance and its live examples. (Frame/responsive/container: see XLE header above.)
@@ -89,7 +91,7 @@ const COMPONENT_DOCS: Record<
89
91
  },
90
92
  };
91
93
 
92
- const ACTIVE_DOCS = COMPONENT_DOCS["button"];
94
+ const ACTIVE_DOCS = COMPONENT_DOCS.button;
93
95
 
94
96
  // One preview node per example in ACTIVE_DOCS.examples, index-aligned. The
95
97
  // old EXAMPLE_PREVIEWS record carried only this key, so the record wrapper
@@ -141,6 +143,9 @@ function ComponentDetailView() {
141
143
  height="auto"
142
144
  contentWidth={960}
143
145
  end={
146
+ // Dropped below 768 on purpose: this rail is in-page navigation, not
147
+ // content. Every heading stays reachable by scrolling, and two rails on a
148
+ // phone would eat the column the prose needs.
144
149
  isMobile ? undefined : (
145
150
  <LayoutPanel
146
151
  isScrollable={false}
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Technical Documentation",
4
4
  description: "Install steps, theming setup, and next steps",
5
+ keywords: ["documentation", "technical", "api reference", "spec", "manual", "reference"],
5
6
  category: "docs",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > (LC > V[g=8] > (V[g=2] > Hd"Getting started with Astryx Dracula"[level=1] + Tx"Last updated March 30, 2026"[t=supporting]) + (C > V[g=3] > (H[j=between] > (H[g=2] > Ic + Tx"AI Assistance"[t=body]) + B"Copy prompt") + Tx"Prompt description"[t=body]) + (V[g=4] > Hd"Prerequisites"[level=2] + UL) + D + (V[g=4] > Hd"Install the package"[level=2] + Tx"Description"[t=body] + (V[g=2] > Tx"Step"[t=body] + Cd)*3) + D + (V[g=4] > Hd"Configure theming"[level=2] + Tx"Description"[t=body] + Cd + Tx"Note"[t=body]) + D + (V[g=4] > Hd"Next steps"[level=2] + UL)) + (LP > Outline)
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=auto mw=960] > (LC[p=8 !scroll] > V[g=8] > (V[g=2] > Hd"Getting started with Astryx Dracula"[level=1 t=display-2] + Tx"Last updated March 30, 2026"[t=supporting] + SE{Selector}"On this page") + (C > V[g=3] > (H[g=2 a=center] > (SI[fill] > (H[g=2 a=center] > Ic + Tx"AI Assistance"[t=body])) + B.ghost"Copy prompt") + Tx"Help me get set up"[t=body]) + (V[g=4] > Hd"Prerequisites"[level=2] + (UL[density=compact] > LI"Node.js 18+" + LI"React 18 or 19" + LI"A package manager")) + D + (V[g=4] > Hd"Install the package"[level=2] + Tx"Description"[t=body] + (V[g=2] > Tx"Step 1"[t=body] + Cd) + (V[g=2] > Tx"Step 2"[t=body] + Tx"Astryx ships precompiled CSS"[t=body] + Cd) + (V[g=2] > Tx"Step 3"[t=body] + Cd)) + D + (V[g=4] > Hd"Configure theming"[level=2] + Tx"Description"[t=body] + Cd + Tx"Note"[t=body]) + D + (V[g=4] > Hd"Next steps"[level=2] + (UL[density=compact] > LI"Fundamental concepts" + LI"Component API reference" + LI"Accessibility" + LI"CLI tools" + LI"Design tokens"))) + (LP[!scroll] > Outline)
4
6
 
5
7
  import { Button } from "@astryxdesign/core/Button";
6
8
  import { Card } from "@astryxdesign/core/Card";
@@ -61,6 +63,9 @@ export default function DocumentationTechnical() {
61
63
  height="auto"
62
64
  contentWidth={960}
63
65
  end={
66
+ // Dropped below 768 on purpose: this rail is in-page navigation, not
67
+ // content. Every heading stays reachable by scrolling, and two rails on a
68
+ // phone would eat the column the prose needs.
64
69
  isMobile ? undefined : (
65
70
  <LayoutPanel
66
71
  isScrollable={false}
@@ -76,7 +81,9 @@ export default function DocumentationTechnical() {
76
81
  <LayoutContent isScrollable={false} padding={8}>
77
82
  <VStack gap={8}>
78
83
  <VStack gap={2}>
79
- <Heading level={1}>Getting started with Astryx Dracula</Heading>
84
+ <Heading level={1} type="display-2">
85
+ Getting started with Astryx Dracula
86
+ </Heading>
80
87
  <Text type="supporting" color="secondary" hasTabularNumbers>
81
88
  Last updated March 30, 2026
82
89
  </Text>
@@ -114,9 +121,7 @@ export default function DocumentationTechnical() {
114
121
  />
115
122
  </HStack>
116
123
  <Text type="body" color="secondary">
117
- Help me get set up with Astryx Dracula. Based on my project, do the following: 1.
118
- Install @astryxdesign/core and the StyleX compiler. 2. Wrap my app in the Theme
119
- component. 3. Replace one existing component with an Astryx equivalent.
124
+ {SETUP_PROMPT}
120
125
  </Text>
121
126
  </VStack>
122
127
  </Card>
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Component Catalog",
4
4
  description: "Hero plus categorized component grid",
5
+ keywords: ["documentation", "docs", "guide", "manual", "reference", "handbook"],
5
6
  category: "docs",
6
7
  };
@@ -1,10 +1,13 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // Counts: 31 total, Core 18 / Layout 4 / Navigation 4 / Form 5. Derived at
4
- // render from COMPONENT_CATEGORIES, so these numerals must move together with
5
- // the array -- the gate in scripts/check.ts reads the rendered count, not this
6
- // comment.
7
- // L > LC > V[g=10] > (C[p=10] > (H[g=8 a=center] > (V[g=4] > Hd"The coven grimoire"[level=1 t=display-1] + Tx.lg"Every incantation in the Astryx spellbook"[t=large] + (H > B.primary"Enter the grimoire")))) + (V[g=4] > (H[j=between a=center] > Hd"Core"[level=2] + Tx"18 spells"[t=body]) + (H[j=between a=center] > Hd"Layout"[level=2] + Tx"4 spells"[t=body]) + (H[j=between a=center] > Hd"Navigation"[level=2] + Tx"4 spells"[t=body]) + (H[j=between a=center] > Hd"Form"[level=2] + Tx"5 spells"[t=body]) + (G[c={min:260} g=4] > (CC[p=4] > V[g=3] > C[p=0] + (V[g=1] > Tx"Avatar"[t=body] + Tx"Avatars represent"[t=body]))*4))
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // Counts: 31 total, Core 18 / Layout 4 / Navigation 4 / Form 5. The page derives
6
+ // every rendered count from COMPONENT_CATEGORIES; the numerals here are the
7
+ // header's copy of that count and must be moved by hand with the array — no
8
+ // gate reads them (scripts/check.ts gates component names in a header, not
9
+ // counts).
10
+ // L[h=fill mw=1200] > LC[p=8] > V[g=10] > (C.transparent[p=10] > (H[g=8 a=center] > (SI[fill] > V[g=4] > Hd"The coven grimoire"[level=1 t=display-2] + Tx.lg"Every incantation in the Astryx spellbook"[t=large] + (H > B.primary"Enter the grimoire")))) + (V[g=4] > (H[j=between a=center] > Hd"Core"[level=2] + Tx"18 spells"[t=body]) + (G[c={min:260} g=4] > (CC.transparent[p=4] > V[g=3] > (C.muted[p=0 minH=160] > Scene{SceneTile}) + (V[g=1] > Tx"AppShell"[t=body] + Tx"AppShell provides"[t=body]))*18)) + (V[g=4] > (H[j=between a=center] > Hd"Layout"[level=2] + Tx"4 spells"[t=body]) + (G[c={min:260} g=4] > (CC.transparent[p=4] > V[g=3] > (C.muted[p=0 minH=160] > Scene{SceneTile}) + (V[g=1] > Tx"Card"[t=body] + Tx"Cards group"[t=body]))*4)) + (V[g=4] > (H[j=between a=center] > Hd"Navigation"[level=2] + Tx"4 spells"[t=body]) + (G[c={min:260} g=4] > (CC.transparent[p=4] > V[g=3] > (C.muted[p=0 minH=160] > Scene{SceneTile}) + (V[g=1] > Tx"Breadcrumbs"[t=body] + Tx"Breadcrumbs show"[t=body]))*4)) + (V[g=4] > (H[j=between a=center] > Hd"Form"[level=2] + Tx"5 spells"[t=body]) + (G[c={min:260} g=4] > (CC.transparent[p=4] > V[g=3] > (C.muted[p=0 minH=160] > Scene{SceneTile}) + (V[g=1] > Tx"CheckboxInput"[t=body] + Tx"CheckboxInput renders"[t=body]))*5))
8
11
 
9
12
  /**
10
13
  * Documentation catalog — every component shelf in the grimoire. Frame-first layout (see `bunx astryx docs layout`): (Frame/responsive/container: see XLE header above.)
@@ -22,6 +25,11 @@ import type { SceneHue } from "astryx-dracula/shared/scene-hues";
22
25
  import { SceneTile } from "astryx-dracula/shared/scene-tile";
23
26
  import type { CSSProperties } from "react";
24
27
 
28
+ // Definite ancestor for `height="fill"`: 100dvh, not minHeight: '100%' (a
29
+ // percentage min-height against an indefinite block computes to 0 — CSS 2.1
30
+ // 10.5). Templates ship standalone, so the page owns this, not the host.
31
+ const pageStyle: CSSProperties = { height: "100dvh" };
32
+
25
33
  // Negative margin offsets each card's 8px padding so the grid content stays
26
34
  // visually aligned while giving every card a padded hover/click target.
27
35
  const cardGrid: CSSProperties = {
@@ -242,6 +250,7 @@ const COMPONENT_TOTAL = COMPONENT_CATEGORIES.reduce(
242
250
  export default function DocumentationCatalog() {
243
251
  return (
244
252
  <Layout
253
+ style={pageStyle}
245
254
  height="fill"
246
255
  contentWidth={1200}
247
256
  content={
@@ -251,7 +260,7 @@ export default function DocumentationCatalog() {
251
260
  <HStack gap={8} vAlign="center">
252
261
  <StackItem size="fill">
253
262
  <VStack gap={4}>
254
- <Heading level={1} type="display-1">
263
+ <Heading level={1} type="display-2">
255
264
  The coven grimoire
256
265
  </Heading>
257
266
  <Text type="large" weight="normal" color="secondary">
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Page Editor",
4
4
  description: "Block builder with sidebar config and preview",
5
+ keywords: ["editor", "ide", "code", "workspace", "files", "developer"],
5
6
  category: "tooling",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > (LP[w=320] > V[g=4] > (S[p=4] > V[g=4] > Hd"Page Editor"[level=1] + Tbar) + (V[g=4] > (TL > Tab"Blocks"! + Tab"Properties") + D + (S[p=4] > V[g=2] > Hd"Add Block"[level=3] + UL + Hd"Layers"[level=3] + UL))) + (LC > V[g=4] > C*3)
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill] > (LP[w=320 p=0 divider] > V[g=4] > (S.transparent[p=4] > V[g=4] > (TI"Page title" + Hd"Page Editor"[level=1 t=display-2]) + Tbar) + (V[g=4] > (V[g=0] > (TL > Tab"Blocks"! + Tab"Properties") + D) + (S.transparent[p=4] > (V[g=2] > (V[g=1] > Hd"Add Block"[level=3] + UL) + (V[g=1] > Hd"Layers"[level=3] + UL)) + (V[g=4] > TI"Heading" + TA"Description")))) + (LC[p=8] > V[g=4] > SC*3) ;; Dlg[variant=fullscreen p=0] > L[h=fill] > (LH[divider] > (H[g=3 j=between a=center] > Hd"Customize"[level=3] + IB"Close")) + (LC[p=0] > (V[g=4] > (V[g=0] > (TL > Tab"Blocks"! + Tab"Properties") + D) + (S.transparent[p=4] > (V[g=2] > (V[g=1] > Hd"Add Block"[level=3] + UL) + (V[g=1] > Hd"Layers"[level=3] + UL)) + (V[g=4] > TI"Heading" + TA"Description")))))
4
6
 
5
7
  import { Button } from "@astryxdesign/core/Button";
6
8
  import { Center } from "@astryxdesign/core/Center";
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "File Explorer",
4
4
  description: "Column-based file browser with preview",
5
+ keywords: ["file explorer", "files", "browser", "directories", "storage", "disk"],
5
6
  category: "tooling",
6
7
  };
@@ -1,6 +1,8 @@
1
1
  // Copyright (c) Meta Platforms, Inc. and affiliates.
2
- // XLE (canonical structure, validated with `bunx astryx layout check`):
3
- // L > (Tbar[size=sm] > (H > IB"Go back" + IB"Go forward" + Tx"Folder"[t=label]) + (SG"View mode" > SGI*4) + (H > IB"Group" + IB"Share" + IB"Tags" + IB"More" + IB"Search")) + (LC[p=0 !scroll] > (Hd"File Explorer"[level=1] + H[h=fill] > (S.transparent[p=2 w=240 dv=[end]] > UL[density=compact !hasDividers] > (LI > Ic + Tx"Item"[t=body])*3)*3 + (S.transparent[p=6] > V[g=4 a=center] > Av[size=96] + (V[g=1 a=center] > Tx"Name"[t=body] + Tx"Kind"[t=supporting]) + (ML"Information" > MLI*3))))
2
+ // XLE (canonical structure of the tree below; the CLI had no XLE validator
3
+ // after `astryx layout` was removed in 0.7.0, so this is a reading aid and a
4
+ // human drift check — update it with the file, never alone):
5
+ // L[h=fill] > (Tbar[size=sm dv=[bottom]] > (IB"Go back" + IB"Go forward" + Tx"Folder"[t=label]) + (SG"View mode" > SGI*4) + (IB"Group" + IB"Share" + IB"Tags" + IB"More" + IB"Search")) + (LC[p=0 !scroll] > (VH"File Explorer" + H[h=100%] > (S.transparent[p=2 w=240 dv=[end]] > UL[density=compact !hasDividers] > (LI > Ic + Tx"Item"[t=body])*3)*3 + (S.transparent[p=4 w=320] > V[g=4 a=center] > Av[size=96] + (V[g=1 a=center] > Tx"Name"[t=body] + Tx"Kind"[t=supporting]) + (ML"Information" > MLI*3))))
4
6
 
5
7
  import { Avatar } from "@astryxdesign/core/Avatar";
6
8
  import { EmptyState } from "@astryxdesign/core/EmptyState";
@@ -2,5 +2,6 @@ export default {
2
2
  type: "page",
3
3
  name: "Two-column Form",
4
4
  description: "Contact form with illustration and info strip",
5
+ keywords: ["form", "two column", "contact", "split", "signup", "lead"],
5
6
  category: "forms",
6
7
  };