@astryxdesign/cli 0.1.2-canary.ff01f6d → 0.1.3-canary.6d57c8d

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 (141) hide show
  1. package/CHANGELOG.md +64 -1
  2. package/README.md +49 -55
  3. package/docs/layout.doc.dense.mjs +90 -0
  4. package/docs/layout.doc.mjs +160 -0
  5. package/docs/principles.doc.dense.mjs +2 -2
  6. package/docs/principles.doc.mjs +4 -0
  7. package/docs/principles.doc.zh.mjs +2 -2
  8. package/package.json +7 -7
  9. package/src/api/blog.mjs +192 -0
  10. package/src/api/blog.test.mjs +144 -0
  11. package/src/api/doctor.mjs +3 -3
  12. package/src/api/index.mjs +1 -0
  13. package/src/codemods/transforms/v0.1.0/__tests__/migrate-xds-css-surfaces.test.mjs +67 -0
  14. package/src/codemods/transforms/v0.1.0/__tests__/migrate-xds-declare-module.test.mjs +61 -0
  15. package/src/codemods/transforms/v0.1.0/__tests__/v0.1.0-ordering.test.mjs +23 -0
  16. package/src/codemods/transforms/v0.1.0/index.mjs +28 -0
  17. package/src/codemods/transforms/v0.1.0/migrate-xds-css-surfaces.mjs +77 -0
  18. package/src/codemods/transforms/v0.1.0/migrate-xds-declare-module.mjs +78 -0
  19. package/src/commands/agent-docs.mjs +4 -1
  20. package/src/commands/blog.mjs +60 -0
  21. package/src/commands/build-theme.import-path.test.mjs +2 -12
  22. package/src/commands/build-theme.mjs +117 -0
  23. package/src/commands/build-theme.prose.test.mjs +5 -15
  24. package/src/commands/build-theme.watch.test.mjs +149 -0
  25. package/src/commands/ensure-core-built.mjs +120 -0
  26. package/src/index.mjs +1 -0
  27. package/src/lib/error-codes.mjs +8 -0
  28. package/src/lib/site.mjs +20 -0
  29. package/templates/blocks/components/AvatarStatusDot/AvatarStatusDotVariants.doc.mjs +14 -0
  30. package/templates/blocks/components/AvatarStatusDot/AvatarStatusDotVariants.tsx +28 -0
  31. package/templates/blocks/components/Blockquote/BlockquoteTestimonials.doc.mjs +14 -0
  32. package/templates/blocks/components/Blockquote/BlockquoteTestimonials.tsx +34 -0
  33. package/templates/blocks/components/Blockquote/BlockquoteWithCite.doc.mjs +14 -0
  34. package/templates/blocks/components/Blockquote/BlockquoteWithCite.tsx +21 -0
  35. package/templates/blocks/components/BreadcrumbItem/BreadcrumbItemBasic.doc.mjs +14 -0
  36. package/templates/blocks/components/BreadcrumbItem/BreadcrumbItemBasic.tsx +15 -0
  37. package/templates/blocks/components/ButtonGroup/ButtonGroupBasic.doc.mjs +14 -0
  38. package/templates/blocks/components/ButtonGroup/ButtonGroupBasic.tsx +16 -0
  39. package/templates/blocks/components/ChatDictationButton/ChatDictationButtonBasic.doc.mjs +19 -0
  40. package/templates/blocks/components/ChatDictationButton/ChatDictationButtonBasic.tsx +34 -0
  41. package/templates/blocks/components/CheckboxListItem/CheckboxListItemBasic.doc.mjs +14 -0
  42. package/templates/blocks/components/CheckboxListItem/CheckboxListItemBasic.tsx +30 -0
  43. package/templates/blocks/components/CollapsibleGroup/CollapsibleGroupAccordion.doc.mjs +14 -0
  44. package/templates/blocks/components/CollapsibleGroup/CollapsibleGroupAccordion.tsx +31 -0
  45. package/templates/blocks/components/CommandPaletteEmpty/CommandPaletteEmptyBasic.doc.mjs +14 -0
  46. package/templates/blocks/components/CommandPaletteEmpty/CommandPaletteEmptyBasic.tsx +26 -0
  47. package/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterBasic.doc.mjs +14 -0
  48. package/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterBasic.tsx +32 -0
  49. package/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupBasic.doc.mjs +18 -0
  50. package/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupBasic.tsx +32 -0
  51. package/templates/blocks/components/CommandPaletteItem/CommandPaletteItemBasic.doc.mjs +14 -0
  52. package/templates/blocks/components/CommandPaletteItem/CommandPaletteItemBasic.tsx +27 -0
  53. package/templates/blocks/components/ContextMenu/ContextMenuBasic.doc.mjs +14 -0
  54. package/templates/blocks/components/ContextMenu/ContextMenuBasic.tsx +32 -0
  55. package/templates/blocks/components/DialogHeader/DialogHeaderBasic.doc.mjs +14 -0
  56. package/templates/blocks/components/DialogHeader/DialogHeaderBasic.tsx +30 -0
  57. package/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.tsx +0 -6
  58. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemBasic.doc.mjs +14 -0
  59. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemBasic.tsx +27 -0
  60. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.tsx +1 -5
  61. package/templates/blocks/components/FieldLabel/FieldLabelBasic.doc.mjs +14 -0
  62. package/templates/blocks/components/FieldLabel/FieldLabelBasic.tsx +20 -0
  63. package/templates/blocks/components/FieldStatus/FieldStatusBasic.doc.mjs +14 -0
  64. package/templates/blocks/components/FieldStatus/FieldStatusBasic.tsx +23 -0
  65. package/templates/blocks/components/FileInput/FileInputBasic.doc.mjs +14 -0
  66. package/templates/blocks/components/FileInput/FileInputBasic.tsx +22 -0
  67. package/templates/blocks/components/GridSpan/GridSpanColumns.doc.mjs +14 -0
  68. package/templates/blocks/components/GridSpan/GridSpanColumns.tsx +38 -0
  69. package/templates/blocks/components/HStack/HStackBasic.doc.mjs +14 -0
  70. package/templates/blocks/components/HStack/HStackBasic.tsx +16 -0
  71. package/templates/blocks/components/Hooks/useKeyboardHintHookUsage.doc.mjs +14 -0
  72. package/templates/blocks/components/Hooks/useKeyboardHintHookUsage.tsx +57 -0
  73. package/templates/blocks/components/InputGroup/InputGroupBasic.doc.mjs +14 -0
  74. package/templates/blocks/components/InputGroup/InputGroupBasic.tsx +27 -0
  75. package/templates/blocks/components/LayoutContent/LayoutContentBasic.doc.mjs +23 -0
  76. package/templates/blocks/components/LayoutContent/LayoutContentBasic.tsx +40 -0
  77. package/templates/blocks/components/LayoutFooter/LayoutFooterActions.doc.mjs +22 -0
  78. package/templates/blocks/components/LayoutFooter/LayoutFooterActions.tsx +41 -0
  79. package/templates/blocks/components/LayoutHeader/LayoutHeaderWithActions.doc.mjs +23 -0
  80. package/templates/blocks/components/LayoutHeader/LayoutHeaderWithActions.tsx +40 -0
  81. package/templates/blocks/components/LayoutPanel/LayoutPanelNavigation.doc.mjs +22 -0
  82. package/templates/blocks/components/LayoutPanel/LayoutPanelNavigation.tsx +37 -0
  83. package/templates/blocks/components/Lightbox/LightboxGallery.doc.mjs +14 -0
  84. package/templates/blocks/components/Lightbox/LightboxGallery.tsx +53 -0
  85. package/templates/blocks/components/Lightbox/LightboxShowcase.tsx +4 -3
  86. package/templates/blocks/components/Lightbox/LightboxVideo.doc.mjs +14 -0
  87. package/templates/blocks/components/Lightbox/LightboxVideo.tsx +27 -0
  88. package/templates/blocks/components/Lightbox/LightboxZoom.doc.mjs +14 -0
  89. package/templates/blocks/components/Lightbox/LightboxZoom.tsx +33 -0
  90. package/templates/blocks/components/MetadataListItem/MetadataListItemBasic.doc.mjs +14 -0
  91. package/templates/blocks/components/MetadataListItem/MetadataListItemBasic.tsx +19 -0
  92. package/templates/blocks/components/MobileNavToggle/MobileNavToggleBasic.doc.mjs +23 -0
  93. package/templates/blocks/components/MobileNavToggle/MobileNavToggleBasic.tsx +42 -0
  94. package/templates/blocks/components/MoreMenu/MoreMenuShowcase.tsx +0 -6
  95. package/templates/blocks/components/NavIcon/NavIconBasic.doc.mjs +14 -0
  96. package/templates/blocks/components/NavIcon/NavIconBasic.tsx +16 -0
  97. package/templates/blocks/components/RadioListItem/RadioListItemBasic.doc.mjs +14 -0
  98. package/templates/blocks/components/RadioListItem/RadioListItemBasic.tsx +30 -0
  99. package/templates/blocks/components/Resizable/ResizableSidebar.doc.mjs +25 -0
  100. package/templates/blocks/components/Resizable/ResizableSidebar.tsx +67 -0
  101. package/templates/blocks/components/SegmentedControlItem/SegmentedControlItemBasic.doc.mjs +14 -0
  102. package/templates/blocks/components/SegmentedControlItem/SegmentedControlItemBasic.tsx +21 -0
  103. package/templates/blocks/components/SelectorOption/SelectorOptionBasic.doc.mjs +14 -0
  104. package/templates/blocks/components/SelectorOption/SelectorOptionBasic.tsx +39 -0
  105. package/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonBasic.doc.mjs +14 -0
  106. package/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonBasic.tsx +55 -0
  107. package/templates/blocks/components/SideNavHeading/SideNavHeadingBasic.doc.mjs +14 -0
  108. package/templates/blocks/components/SideNavHeading/SideNavHeadingBasic.tsx +38 -0
  109. package/templates/blocks/components/SideNavItem/SideNavItemBasic.doc.mjs +14 -0
  110. package/templates/blocks/components/SideNavItem/SideNavItemBasic.tsx +49 -0
  111. package/templates/blocks/components/SideNavSection/SideNavSectionBasic.doc.mjs +14 -0
  112. package/templates/blocks/components/SideNavSection/SideNavSectionBasic.tsx +71 -0
  113. package/templates/blocks/components/StackItem/StackItemFill.doc.mjs +14 -0
  114. package/templates/blocks/components/StackItem/StackItemFill.tsx +28 -0
  115. package/templates/blocks/components/TabMenu/TabMenuBasic.doc.mjs +14 -0
  116. package/templates/blocks/components/TabMenu/TabMenuBasic.tsx +23 -0
  117. package/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupVertical.doc.mjs +14 -0
  118. package/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupVertical.tsx +47 -0
  119. package/templates/blocks/components/TopNavHeading/TopNavHeadingBasic.doc.mjs +14 -0
  120. package/templates/blocks/components/TopNavHeading/TopNavHeadingBasic.tsx +22 -0
  121. package/templates/blocks/components/TopNavItem/TopNavItemBasic.doc.mjs +14 -0
  122. package/templates/blocks/components/TopNavItem/TopNavItemBasic.tsx +21 -0
  123. package/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuBasic.doc.mjs +20 -0
  124. package/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuBasic.tsx +46 -0
  125. package/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardBasic.doc.mjs +14 -0
  126. package/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardBasic.tsx +16 -0
  127. package/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemBasic.doc.mjs +14 -0
  128. package/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemBasic.tsx +26 -0
  129. package/templates/blocks/components/TopNavMenu/TopNavMenuBasic.doc.mjs +14 -0
  130. package/templates/blocks/components/TopNavMenu/TopNavMenuBasic.tsx +43 -0
  131. package/templates/blocks/components/TypeaheadItem/TypeaheadItemBasic.doc.mjs +14 -0
  132. package/templates/blocks/components/TypeaheadItem/TypeaheadItemBasic.tsx +43 -0
  133. package/templates/blocks/components/VStack/VStackBasic.doc.mjs +14 -0
  134. package/templates/blocks/components/VStack/VStackBasic.tsx +20 -0
  135. package/templates/pages/kanban-board/page.tsx +729 -0
  136. package/templates/pages/kanban-board/template.doc.mjs +12 -0
  137. package/templates/pages/shell-side-nav/page.tsx +0 -1
  138. package/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs +0 -14
  139. package/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.tsx +0 -64
  140. package/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs +0 -14
  141. package/templates/blocks/components/TreeListItem/TreeListItemShowcase.tsx +0 -60
@@ -0,0 +1,43 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {useState} from 'react';
6
+ import {Typeahead, TypeaheadItem} from '@astryxdesign/core/Typeahead';
7
+ import type {SearchableItem, SearchSource} from '@astryxdesign/core/Typeahead';
8
+ import {Center} from '@astryxdesign/core/Center';
9
+
10
+ interface PersonItem extends SearchableItem {
11
+ auxiliaryData: {role: string};
12
+ }
13
+
14
+ const people: PersonItem[] = [
15
+ {id: '1', label: 'Alice Johnson', auxiliaryData: {role: 'Engineer'}},
16
+ {id: '2', label: 'Bob Smith', auxiliaryData: {role: 'Designer'}},
17
+ {id: '3', label: 'Charlie Brown', auxiliaryData: {role: 'Product Manager'}},
18
+ ];
19
+
20
+ const peopleSource: SearchSource<PersonItem> = {
21
+ search: (query: string) =>
22
+ people.filter(p => p.label.toLowerCase().includes(query.toLowerCase())),
23
+ bootstrap: () => people,
24
+ };
25
+
26
+ export default function TypeaheadItemBasic() {
27
+ const [value, setValue] = useState<PersonItem | null>(null);
28
+
29
+ return (
30
+ <Center width={320}>
31
+ <Typeahead
32
+ label="Assignee"
33
+ placeholder="Search people..."
34
+ searchSource={peopleSource}
35
+ value={value}
36
+ onChange={setValue}
37
+ renderItem={(item: PersonItem) => (
38
+ <TypeaheadItem item={item} description={item.auxiliaryData.role} />
39
+ )}
40
+ />
41
+ </Center>
42
+ );
43
+ }
@@ -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: 'VStack',
7
+ name: 'VStack — Basic',
8
+ displayName: 'VStack — Basic',
9
+ description:
10
+ 'A heading and paragraphs stacked vertically with a consistent gap. Use VStack whenever siblings should flow top to bottom with even spacing.',
11
+ isReady: true,
12
+ aspectRatio: 16 / 9,
13
+ componentsUsed: ['VStack', 'Text', 'Heading'],
14
+ };
@@ -0,0 +1,20 @@
1
+ // Copyright (c) Meta Platforms, Inc. and affiliates.
2
+
3
+ 'use client';
4
+
5
+ import {VStack} from '@astryxdesign/core/Layout';
6
+ import {Text, Heading} from '@astryxdesign/core/Text';
7
+
8
+ export default function VStackBasic() {
9
+ return (
10
+ <VStack gap={3}>
11
+ <Heading level={5}>Weekly Report</Heading>
12
+ <Text type="body" color="secondary">
13
+ VStack arranges its children in a vertical column.
14
+ </Text>
15
+ <Text type="body" color="secondary">
16
+ The gap prop controls the spacing between each item.
17
+ </Text>
18
+ </VStack>
19
+ );
20
+ }