@astryxdesign/cli 0.1.4 → 0.1.5-canary.3f81427

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 (77) hide show
  1. package/CHANGELOG.md +45 -1
  2. package/docs/getting-started.doc.mjs +4 -0
  3. package/docs/migration.doc.mjs +134 -0
  4. package/docs/styling.doc.mjs +53 -0
  5. package/docs/working-with-ai.doc.mjs +1 -1
  6. package/package.json +15 -10
  7. package/src/api/component.mjs +2 -1
  8. package/src/api/doctor.mjs +13 -2
  9. package/src/api/template.mjs +14 -3
  10. package/src/codemods/__tests__/registry.test.mjs +1 -0
  11. package/src/codemods/__tests__/runner.test.mjs +38 -0
  12. package/src/codemods/registry.mjs +1 -0
  13. package/src/codemods/runner.mjs +2 -0
  14. package/src/codemods/transforms/v0.1.5/__tests__/rename-switch-label-spacing-default-to-hug.test.mjs +93 -0
  15. package/src/codemods/transforms/v0.1.5/index.mjs +19 -0
  16. package/src/codemods/transforms/v0.1.5/rename-switch-label-spacing-default-to-hug.mjs +140 -0
  17. package/src/commands/agent-docs.mjs +9 -6
  18. package/src/commands/agent-docs.test.mjs +33 -0
  19. package/src/commands/build-theme.color-scheme.test.mjs +153 -0
  20. package/src/commands/build-theme.mjs +112 -14
  21. package/src/commands/build-theme.variants.test.mjs +193 -0
  22. package/src/commands/component-resolution.test.mjs +4 -4
  23. package/src/commands/doctor.test.mjs +34 -0
  24. package/src/commands/init.mjs +1 -1
  25. package/src/commands/swizzle.mjs +34 -0
  26. package/src/commands/swizzle.routing.test.mjs +67 -0
  27. package/src/lib/component-discovery.mjs +8 -4
  28. package/templates/blocks/components/AspectRatio/AspectRatioCircleImage.tsx +1 -6
  29. package/templates/blocks/components/AspectRatio/AspectRatioImageGallery.tsx +2 -7
  30. package/templates/blocks/components/AspectRatio/AspectRatioShowcase.tsx +2 -5
  31. package/templates/blocks/components/AspectRatio/AspectRatioSquareImage.tsx +1 -6
  32. package/templates/blocks/components/AspectRatio/AspectRatioWidescreen.tsx +1 -6
  33. package/templates/blocks/components/BaseTypeahead/BaseTypeaheadCustomSearch.doc.mjs +14 -0
  34. package/templates/blocks/components/BaseTypeahead/BaseTypeaheadCustomSearch.tsx +58 -0
  35. package/templates/blocks/components/CodeBlock/CodeBlockTerminal.doc.mjs +14 -0
  36. package/templates/blocks/components/CodeBlock/CodeBlockTerminal.tsx +24 -0
  37. package/templates/blocks/components/Collapsible/CollapsibleDividedAccordion.doc.mjs +13 -0
  38. package/templates/blocks/components/Collapsible/CollapsibleDividedAccordion.tsx +33 -0
  39. package/templates/blocks/components/Collapsible/CollapsibleWithoutCard.tsx +25 -23
  40. package/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupShowcase.tsx +27 -48
  41. package/templates/blocks/components/CommandPaletteInput/CommandPaletteInputBasic.doc.mjs +15 -0
  42. package/templates/blocks/components/CommandPaletteInput/CommandPaletteInputBasic.tsx +39 -0
  43. package/templates/blocks/components/CommandPaletteInput/CommandPaletteInputShowcase.doc.mjs +15 -0
  44. package/templates/blocks/components/CommandPaletteInput/CommandPaletteInputShowcase.tsx +39 -0
  45. package/templates/blocks/components/CommandPaletteItem/CommandPaletteItemShowcase.tsx +31 -54
  46. package/templates/blocks/components/CommandPaletteList/CommandPaletteListBasic.doc.mjs +15 -0
  47. package/templates/blocks/components/CommandPaletteList/CommandPaletteListBasic.tsx +27 -0
  48. package/templates/blocks/components/CommandPaletteList/CommandPaletteListShowcase.doc.mjs +15 -0
  49. package/templates/blocks/components/CommandPaletteList/CommandPaletteListShowcase.tsx +38 -0
  50. package/templates/blocks/components/ContextMenuItem/ContextMenuItemBasic.doc.mjs +14 -0
  51. package/templates/blocks/components/ContextMenuItem/ContextMenuItemBasic.tsx +44 -0
  52. package/templates/blocks/components/ContextMenuItem/ContextMenuItemShowcase.doc.mjs +15 -0
  53. package/templates/blocks/components/ContextMenuItem/ContextMenuItemShowcase.tsx +107 -0
  54. package/templates/blocks/components/NavHeadingMenu/NavHeadingMenuShowcase.doc.mjs +15 -0
  55. package/templates/blocks/components/NavHeadingMenu/NavHeadingMenuShowcase.tsx +47 -0
  56. package/templates/blocks/components/Table/TableGroupedRowsTable.doc.mjs +14 -0
  57. package/templates/blocks/components/Table/TableGroupedRowsTable.tsx +66 -0
  58. package/templates/blocks/components/Table/TableRowIndexTable.doc.mjs +14 -0
  59. package/templates/blocks/components/Table/TableRowIndexTable.tsx +47 -0
  60. package/templates/pages/classic-gallery/page.tsx +1 -1
  61. package/templates/pages/dashboard/page.tsx +1 -1
  62. package/templates/pages/documentation/page.tsx +1 -1
  63. package/templates/pages/incident-console/page.tsx +580 -0
  64. package/templates/pages/incident-console/template.doc.mjs +12 -0
  65. package/templates/pages/kanban-board/page.tsx +37 -13
  66. package/templates/pages/messaging-shell/page.tsx +676 -0
  67. package/templates/pages/messaging-shell/template.doc.mjs +12 -0
  68. package/templates/pages/mixed-gallery/page.tsx +1 -1
  69. package/templates/pages/payment-form/page.tsx +2 -6
  70. package/templates/pages/product-detail/page.tsx +3 -11
  71. package/templates/pages/product-gallery/page.tsx +1 -1
  72. package/templates/pages/settings/page.tsx +1 -1
  73. package/templates/pages/side-gallery/page.tsx +1 -1
  74. package/templates/pages/table-page/page.tsx +1 -1
  75. package/templates/pages/table-page-chart/page.tsx +4 -14
  76. package/templates/pages/table-page-heatmap-status/page.tsx +1 -1
  77. package/templates/pages/table-page-shoe-store-heatmap/page.tsx +5 -19
@@ -0,0 +1,107 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {ContextMenu, ContextMenuItem} from '@astryxdesign/core/ContextMenu';
6
+
7
+ const PencilIcon = (props: React.SVGProps<SVGSVGElement>) => (
8
+ <svg
9
+ viewBox="0 0 24 24"
10
+ fill="none"
11
+ stroke="currentColor"
12
+ strokeWidth={1.5}
13
+ strokeLinecap="round"
14
+ strokeLinejoin="round"
15
+ {...props}>
16
+ <path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7" />
17
+ <path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z" />
18
+ </svg>
19
+ );
20
+
21
+ const CopyIcon = (props: React.SVGProps<SVGSVGElement>) => (
22
+ <svg
23
+ viewBox="0 0 24 24"
24
+ fill="none"
25
+ stroke="currentColor"
26
+ strokeWidth={1.5}
27
+ strokeLinecap="round"
28
+ strokeLinejoin="round"
29
+ {...props}>
30
+ <rect x="9" y="9" width="13" height="13" rx="2" />
31
+ <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
32
+ </svg>
33
+ );
34
+
35
+ const ShareIcon = (props: React.SVGProps<SVGSVGElement>) => (
36
+ <svg
37
+ viewBox="0 0 24 24"
38
+ fill="none"
39
+ stroke="currentColor"
40
+ strokeWidth={1.5}
41
+ strokeLinecap="round"
42
+ strokeLinejoin="round"
43
+ {...props}>
44
+ <circle cx="18" cy="5" r="3" />
45
+ <circle cx="6" cy="12" r="3" />
46
+ <circle cx="18" cy="19" r="3" />
47
+ <line x1="8.59" y1="13.51" x2="15.42" y2="17.49" />
48
+ <line x1="15.41" y1="6.51" x2="8.59" y2="10.49" />
49
+ </svg>
50
+ );
51
+
52
+ const TrashIcon = (props: React.SVGProps<SVGSVGElement>) => (
53
+ <svg
54
+ viewBox="0 0 24 24"
55
+ fill="none"
56
+ stroke="currentColor"
57
+ strokeWidth={1.5}
58
+ strokeLinecap="round"
59
+ strokeLinejoin="round"
60
+ {...props}>
61
+ <polyline points="3 6 5 6 21 6" />
62
+ <path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2" />
63
+ </svg>
64
+ );
65
+
66
+ export default function ContextMenuItemShowcase() {
67
+ return (
68
+ <ContextMenu
69
+ menuContent={
70
+ <>
71
+ <ContextMenuItem
72
+ icon={PencilIcon}
73
+ label="Edit"
74
+ description="Modify this item"
75
+ onClick={() => {}}
76
+ />
77
+ <ContextMenuItem
78
+ icon={CopyIcon}
79
+ label="Duplicate"
80
+ description="Create a copy"
81
+ onClick={() => {}}
82
+ />
83
+ <ContextMenuItem icon={ShareIcon} label="Share" onClick={() => {}} />
84
+ <ContextMenuItem
85
+ icon={TrashIcon}
86
+ label="Delete"
87
+ description="This action cannot be undone"
88
+ onClick={() => {}}
89
+ />
90
+ </>
91
+ }>
92
+ <div
93
+ style={{
94
+ padding: '48px',
95
+ borderWidth: '2px',
96
+ borderStyle: 'dashed',
97
+ borderColor: 'var(--color-border)',
98
+ borderRadius: '8px',
99
+ textAlign: 'center',
100
+ color: 'var(--color-text-secondary)',
101
+ userSelect: 'none',
102
+ }}>
103
+ Right-click this area
104
+ </div>
105
+ </ContextMenu>
106
+ );
107
+ }
@@ -0,0 +1,15 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
4
+ export const doc = {
5
+ type: 'block',
6
+ exampleFor: 'NavHeadingMenu',
7
+ name: 'NavHeadingMenu',
8
+ displayName: 'Nav Heading Menu',
9
+ description:
10
+ 'NavHeadingMenu passed as the menu prop of SideNavHeading, letting the heading act as a product switcher popover trigger.',
11
+ isReady: true,
12
+ isShowcase: true,
13
+ aspectRatio: 4 / 3,
14
+ componentsUsed: ['SideNav', 'SideNavHeading', 'NavHeadingMenu', 'NavHeadingMenuItem'],
15
+ };
@@ -0,0 +1,47 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {SideNav, SideNavHeading} from '@astryxdesign/core/SideNav';
6
+ import {NavHeadingMenu, NavHeadingMenuItem} from '@astryxdesign/core/NavMenu';
7
+
8
+ function AppIcon() {
9
+ return (
10
+ <svg
11
+ width="20"
12
+ height="20"
13
+ viewBox="0 0 24 24"
14
+ fill="none"
15
+ stroke="currentColor"
16
+ strokeWidth="1.5">
17
+ <path
18
+ strokeLinecap="round"
19
+ strokeLinejoin="round"
20
+ d="M3.75 6A2.25 2.25 0 0 1 6 3.75h2.25A2.25 2.25 0 0 1 10.5 6v2.25a2.25 2.25 0 0 1-2.25 2.25H6a2.25 2.25 0 0 1-2.25-2.25V6ZM3.75 15.75A2.25 2.25 0 0 1 6 13.5h2.25a2.25 2.25 0 0 1 2.25 2.25V18a2.25 2.25 0 0 1-2.25 2.25H6A2.25 2.25 0 0 1 3.75 18v-2.25ZM13.5 6a2.25 2.25 0 0 1 2.25-2.25H18A2.25 2.25 0 0 1 20.25 6v2.25A2.25 2.25 0 0 1 18 10.5h-2.25a2.25 2.25 0 0 1-2.25-2.25V6ZM13.5 15.75a2.25 2.25 0 0 1 2.25-2.25H18a2.25 2.25 0 0 1 2.25 2.25V18A2.25 2.25 0 0 1 18 20.25h-2.25a2.25 2.25 0 0 1-2.25-2.25v-2.25Z"
21
+ />
22
+ </svg>
23
+ );
24
+ }
25
+
26
+ export default function NavHeadingMenuShowcase() {
27
+ return (
28
+ <div style={{height: 100}}>
29
+ <SideNav
30
+ header={
31
+ <SideNavHeading
32
+ heading="Acme Platform"
33
+ icon={<AppIcon />}
34
+ menu={
35
+ <NavHeadingMenu size="lg">
36
+ <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
37
+ <NavHeadingMenuItem label="Analytics" href="/analytics" />
38
+ <NavHeadingMenuItem label="Settings" href="/settings" />
39
+ </NavHeadingMenu>
40
+ }
41
+ />
42
+ }>
43
+ {null}
44
+ </SideNav>
45
+ </div>
46
+ );
47
+ }
@@ -0,0 +1,14 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
4
+ export const doc = {
5
+ type: 'block',
6
+ exampleFor: 'useTableGroupedRows',
7
+ name: 'useTableGroupedRows — Collapsible Groups',
8
+ displayName: 'useTableGroupedRows — Collapsible Groups',
9
+ description:
10
+ 'A table grouped into collapsible sections with useTableGroupedRows. Each group gets a full-width header with a chevron, label, and member count; click to collapse/expand.',
11
+ isReady: true,
12
+ aspectRatio: 16 / 9,
13
+ componentsUsed: ['Table'],
14
+ };
@@ -0,0 +1,66 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {useState, useCallback} from 'react';
6
+ import {
7
+ Table,
8
+ useTableGroupedRows,
9
+ proportional,
10
+ pixel,
11
+ } from '@astryxdesign/core/Table';
12
+ import type {TableColumn} from '@astryxdesign/core/Table';
13
+
14
+ interface Person extends Record<string, unknown> {
15
+ id: string;
16
+ name: string;
17
+ team: string;
18
+ role: string;
19
+ }
20
+
21
+ const people: Person[] = [
22
+ {id: '1', name: 'Ava Chen', team: 'Design Systems', role: 'Staff Eng'},
23
+ {id: '2', name: 'Liam Park', team: 'Design Systems', role: 'Engineer'},
24
+ {id: '3', name: 'Zoe Vega', team: 'Design Systems', role: 'Manager'},
25
+ {id: '4', name: 'Max Ross', team: 'Infra', role: 'Senior Eng'},
26
+ {id: '5', name: 'Mia Cole', team: 'Infra', role: 'Engineer'},
27
+ {id: '6', name: 'Leo Nash', team: 'Growth', role: 'PM'},
28
+ ];
29
+
30
+ const columns: TableColumn<Person>[] = [
31
+ {key: 'name', header: 'Name', width: proportional(2)},
32
+ {key: 'role', header: 'Role', width: pixel(140)},
33
+ ];
34
+
35
+ export default function TableGroupedRowsTable() {
36
+ const [collapsedGroups, setCollapsed] = useState<Set<string>>(new Set());
37
+ const onToggleGroup = useCallback((key: string) => {
38
+ setCollapsed(prev => {
39
+ const next = new Set(prev);
40
+ if (next.has(key)) {
41
+ next.delete(key);
42
+ } else {
43
+ next.add(key);
44
+ }
45
+ return next;
46
+ });
47
+ }, []);
48
+
49
+ const grouped = useTableGroupedRows<Person>({
50
+ data: people,
51
+ groupBy: p => p.team,
52
+ collapsedGroups,
53
+ onToggleGroup,
54
+ getRowKey: p => p.id,
55
+ });
56
+
57
+ return (
58
+ <Table
59
+ data={grouped.data}
60
+ columns={columns}
61
+ idKey={grouped.idKey}
62
+ hasHover
63
+ plugins={{grouped: grouped.plugin}}
64
+ />
65
+ );
66
+ }
@@ -0,0 +1,14 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ /** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
4
+ export const doc = {
5
+ type: 'block',
6
+ exampleFor: 'useTableRowIndex',
7
+ name: 'useTableRowIndex — Numbered Rows',
8
+ displayName: 'useTableRowIndex — Numbered Rows',
9
+ description:
10
+ 'A table with a prepended row-number column via useTableRowIndex. Numbering is monospaced, right-aligned, and follows the rendered data order.',
11
+ isReady: true,
12
+ aspectRatio: 16 / 9,
13
+ componentsUsed: ['Table'],
14
+ };
@@ -0,0 +1,47 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {
6
+ Table,
7
+ useTableRowIndex,
8
+ proportional,
9
+ pixel,
10
+ } from '@astryxdesign/core/Table';
11
+ import type {TableColumn} from '@astryxdesign/core/Table';
12
+
13
+ interface Track extends Record<string, unknown> {
14
+ id: string;
15
+ title: string;
16
+ artist: string;
17
+ plays: number;
18
+ }
19
+
20
+ const tracks: Track[] = [
21
+ {id: 't1', title: 'Nightfall', artist: 'Ava Chen', plays: 1820},
22
+ {id: 't2', title: 'Ember', artist: 'Liam Park', plays: 942},
23
+ {id: 't3', title: 'Tidal', artist: 'Zoe Vega', plays: 3310},
24
+ {id: 't4', title: 'Cinder', artist: 'Max Ross', plays: 604},
25
+ {id: 't5', title: 'Halcyon', artist: 'Mia Cole', plays: 2075},
26
+ ];
27
+
28
+ const columns: TableColumn<Track>[] = [
29
+ {key: 'title', header: 'Title', width: proportional(2)},
30
+ {key: 'artist', header: 'Artist', width: proportional(2)},
31
+ {key: 'plays', header: 'Plays', width: pixel(90), align: 'end'},
32
+ ];
33
+
34
+ export default function TableRowIndexTable() {
35
+ // Pass the rendered data array — numbering follows its order.
36
+ const rowIndex = useTableRowIndex<Track>({data: tracks});
37
+
38
+ return (
39
+ <Table
40
+ data={tracks}
41
+ columns={columns}
42
+ idKey="id"
43
+ hasHover
44
+ plugins={{rowIndex}}
45
+ />
46
+ );
47
+ }
@@ -110,7 +110,7 @@ export default function ClassicGalleryTemplate() {
110
110
 
111
111
  return (
112
112
  <Layout
113
- height="auto"
113
+ height="fill"
114
114
  content={
115
115
  <LayoutContent padding={0}>
116
116
  <Center axis="horizontal">
@@ -729,7 +729,7 @@ function TableCard<T extends {id: string}>({
729
729
  export default function DashboardTemplate() {
730
730
  return (
731
731
  <Layout
732
- height="auto"
732
+ height="fill"
733
733
  content={
734
734
  <LayoutContent padding={6}>
735
735
  <VStack gap={6}>
@@ -209,7 +209,7 @@ const COMPONENT_CATEGORIES = [
209
209
  export default function DocumentationOverviewPage() {
210
210
  return (
211
211
  <Layout
212
- height="auto"
212
+ height="fill"
213
213
  contentWidth={1200}
214
214
  content={
215
215
  <LayoutContent padding={8}>