@astryxdesign/cli 0.1.2 → 0.1.3-canary.102854d

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 (245) hide show
  1. package/CHANGELOG.md +64 -1
  2. package/README.md +49 -55
  3. package/docs/browser-support.doc.mjs +200 -0
  4. package/docs/layout.doc.dense.mjs +90 -0
  5. package/docs/layout.doc.mjs +160 -0
  6. package/docs/principles.doc.dense.mjs +2 -2
  7. package/docs/principles.doc.mjs +4 -0
  8. package/docs/principles.doc.zh.mjs +2 -2
  9. package/docs/theme.doc.mjs +4 -4
  10. package/package.json +19 -7
  11. package/src/api/blog.mjs +192 -0
  12. package/src/api/blog.test.mjs +144 -0
  13. package/src/api/component.mjs +253 -12
  14. package/src/api/discover.mjs +14 -7
  15. package/src/api/doctor.mjs +10 -25
  16. package/src/api/index.mjs +1 -0
  17. package/src/api/layout.mjs +11 -10
  18. package/src/api/layout.test.mjs +4 -1
  19. package/src/api/template-integration.test.mjs +225 -0
  20. package/src/api/template.mjs +242 -84
  21. package/src/api/validate-integration.mjs +370 -0
  22. package/src/api/validate-integration.test.mjs +222 -0
  23. package/src/codemod.mjs +93 -0
  24. package/src/codemod.test.mjs +134 -0
  25. package/src/codemods/__tests__/registry.test.mjs +1 -0
  26. package/src/codemods/__tests__/runner.test.mjs +103 -0
  27. package/src/codemods/integration-discovery.mjs +168 -0
  28. package/src/codemods/integration-discovery.test.mjs +234 -0
  29. package/src/codemods/integration-runner.mjs +109 -0
  30. package/src/codemods/registry.mjs +1 -0
  31. package/src/codemods/run-codemod.mjs +207 -0
  32. package/src/codemods/runner.mjs +73 -96
  33. package/src/codemods/transforms/v0.0.15/index.mjs +0 -13
  34. package/src/codemods/transforms/v0.1.0/__tests__/migrate-xds-css-surfaces.test.mjs +67 -0
  35. package/src/codemods/transforms/v0.1.0/__tests__/migrate-xds-declare-module.test.mjs +61 -0
  36. package/src/codemods/transforms/v0.1.0/__tests__/v0.1.0-ordering.test.mjs +104 -0
  37. package/src/codemods/transforms/{v0.0.15 → v0.1.0}/drop-xds-prefix-imports.mjs +15 -4
  38. package/src/codemods/transforms/v0.1.0/index.mjs +43 -6
  39. package/src/codemods/transforms/v0.1.0/migrate-xds-css-surfaces.mjs +77 -0
  40. package/src/codemods/transforms/v0.1.0/migrate-xds-declare-module.mjs +78 -0
  41. package/src/codemods/transforms/v0.1.3/__tests__/migrate-layout-components-to-experimental.test.mjs +360 -0
  42. package/src/codemods/transforms/v0.1.3/index.mjs +19 -0
  43. package/src/codemods/transforms/v0.1.3/migrate-layout-components-to-experimental.mjs +260 -0
  44. package/src/commands/agent-docs.mjs +4 -1
  45. package/src/commands/blog.mjs +60 -0
  46. package/src/commands/build-theme.import-path.test.mjs +2 -12
  47. package/src/commands/build-theme.mjs +117 -0
  48. package/src/commands/build-theme.prose.test.mjs +5 -15
  49. package/src/commands/build-theme.watch.test.mjs +149 -0
  50. package/src/commands/component/index.mjs +44 -10
  51. package/src/commands/component-ownership.test.mjs +227 -0
  52. package/src/commands/discover.mjs +5 -16
  53. package/src/commands/doctor.test.mjs +3 -3
  54. package/src/commands/ensure-core-built.mjs +120 -0
  55. package/src/commands/json-contract.test.mjs +0 -32
  56. package/src/commands/swizzle.mjs +224 -235
  57. package/src/commands/swizzle.path-safety.test.mjs +3 -3
  58. package/src/commands/swizzle.routing.test.mjs +279 -0
  59. package/src/commands/template.mjs +33 -37
  60. package/src/commands/upgrade.config-ordering.test.mjs +273 -0
  61. package/src/commands/upgrade.integration-policy.test.mjs +204 -0
  62. package/src/commands/upgrade.mjs +349 -170
  63. package/src/commands/validate-integration.mjs +110 -0
  64. package/src/commands/validate-integration.test.mjs +124 -0
  65. package/src/config.mjs +7 -20
  66. package/src/config.test.mjs +89 -13
  67. package/src/index.mjs +8 -3
  68. package/src/integration.mjs +19 -0
  69. package/src/lib/component-discovery.mjs +177 -0
  70. package/src/lib/component-format.mjs +13 -2
  71. package/src/lib/component-format.test.mjs +42 -0
  72. package/src/lib/config-cache.mjs +91 -0
  73. package/src/lib/config-cache.test.mjs +83 -0
  74. package/src/lib/config-schema.mjs +41 -55
  75. package/src/lib/error-codes.mjs +15 -12
  76. package/src/lib/integration-warnings.mjs +62 -0
  77. package/src/lib/integration-warnings.test.mjs +102 -0
  78. package/src/lib/integrations.mjs +92 -115
  79. package/src/lib/integrations.test.mjs +88 -107
  80. package/src/lib/manifest.mjs +5 -2
  81. package/src/lib/module-loader.mjs +80 -0
  82. package/src/lib/module-loader.test.mjs +106 -0
  83. package/src/lib/project.mjs +502 -0
  84. package/src/lib/project.test.mjs +308 -0
  85. package/src/lib/site.mjs +20 -0
  86. package/src/template.mjs +73 -0
  87. package/src/template.test.mjs +127 -0
  88. package/src/types/api.d.ts +2 -6
  89. package/src/types/base.d.ts +3 -9
  90. package/src/types/codemod.d.ts +81 -0
  91. package/src/types/component.d.ts +27 -2
  92. package/src/types/config.d.ts +56 -85
  93. package/src/types/error-codes.d.ts +5 -3
  94. package/src/types/index.d.ts +0 -1
  95. package/src/types/integration.d.ts +29 -0
  96. package/src/types/swizzle.d.ts +9 -2
  97. package/src/types/template-api.d.ts +54 -0
  98. package/src/types/template.d.ts +10 -7
  99. package/src/types/upgrade.d.ts +29 -0
  100. package/src/types/validate-integration.d.ts +24 -0
  101. package/src/utils/github.mjs +0 -237
  102. package/src/utils/interactive.mjs +2 -2
  103. package/templates/blocks/components/AvatarStatusDot/AvatarStatusDotVariants.doc.mjs +14 -0
  104. package/templates/blocks/components/AvatarStatusDot/AvatarStatusDotVariants.tsx +28 -0
  105. package/templates/blocks/components/Blockquote/BlockquoteTestimonials.doc.mjs +14 -0
  106. package/templates/blocks/components/Blockquote/BlockquoteTestimonials.tsx +34 -0
  107. package/templates/blocks/components/Blockquote/BlockquoteWithCite.doc.mjs +14 -0
  108. package/templates/blocks/components/Blockquote/BlockquoteWithCite.tsx +21 -0
  109. package/templates/blocks/components/BreadcrumbItem/BreadcrumbItemBasic.doc.mjs +14 -0
  110. package/templates/blocks/components/BreadcrumbItem/BreadcrumbItemBasic.tsx +15 -0
  111. package/templates/blocks/components/ButtonGroup/ButtonGroupBasic.doc.mjs +14 -0
  112. package/templates/blocks/components/ButtonGroup/ButtonGroupBasic.tsx +16 -0
  113. package/templates/blocks/components/ChatDictationButton/ChatDictationButtonBasic.doc.mjs +19 -0
  114. package/templates/blocks/components/ChatDictationButton/ChatDictationButtonBasic.tsx +34 -0
  115. package/templates/blocks/components/CheckboxListItem/CheckboxListItemBasic.doc.mjs +14 -0
  116. package/templates/blocks/components/CheckboxListItem/CheckboxListItemBasic.tsx +30 -0
  117. package/templates/blocks/components/CollapsibleGroup/CollapsibleGroupAccordion.doc.mjs +14 -0
  118. package/templates/blocks/components/CollapsibleGroup/CollapsibleGroupAccordion.tsx +31 -0
  119. package/templates/blocks/components/CommandPaletteEmpty/CommandPaletteEmptyBasic.doc.mjs +14 -0
  120. package/templates/blocks/components/CommandPaletteEmpty/CommandPaletteEmptyBasic.tsx +26 -0
  121. package/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterBasic.doc.mjs +14 -0
  122. package/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterBasic.tsx +32 -0
  123. package/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupBasic.doc.mjs +18 -0
  124. package/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupBasic.tsx +32 -0
  125. package/templates/blocks/components/CommandPaletteItem/CommandPaletteItemBasic.doc.mjs +14 -0
  126. package/templates/blocks/components/CommandPaletteItem/CommandPaletteItemBasic.tsx +27 -0
  127. package/templates/blocks/components/ContextMenu/ContextMenuBasic.doc.mjs +14 -0
  128. package/templates/blocks/components/ContextMenu/ContextMenuBasic.tsx +32 -0
  129. package/templates/blocks/components/DateRangeInput/DateRangeInputWithPresets.doc.mjs +14 -0
  130. package/templates/blocks/components/DateRangeInput/DateRangeInputWithPresets.tsx +46 -0
  131. package/templates/blocks/components/DateRangeInput/DateRangeInputWithValidation.doc.mjs +14 -0
  132. package/templates/blocks/components/DateRangeInput/DateRangeInputWithValidation.tsx +52 -0
  133. package/templates/blocks/components/DateTimeInput/DateTimeInputWithValidation.doc.mjs +14 -0
  134. package/templates/blocks/components/DateTimeInput/DateTimeInputWithValidation.tsx +43 -0
  135. package/templates/blocks/components/DialogHeader/DialogHeaderBasic.doc.mjs +14 -0
  136. package/templates/blocks/components/DialogHeader/DialogHeaderBasic.tsx +30 -0
  137. package/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.tsx +0 -6
  138. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemBasic.doc.mjs +14 -0
  139. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemBasic.tsx +27 -0
  140. package/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.tsx +1 -5
  141. package/templates/blocks/components/FieldLabel/FieldLabelBasic.doc.mjs +14 -0
  142. package/templates/blocks/components/FieldLabel/FieldLabelBasic.tsx +20 -0
  143. package/templates/blocks/components/FieldStatus/FieldStatusBasic.doc.mjs +14 -0
  144. package/templates/blocks/components/FieldStatus/FieldStatusBasic.tsx +23 -0
  145. package/templates/blocks/components/FileInput/FileInputBasic.doc.mjs +14 -0
  146. package/templates/blocks/components/FileInput/FileInputBasic.tsx +22 -0
  147. package/templates/blocks/components/GridSpan/GridSpanColumns.doc.mjs +14 -0
  148. package/templates/blocks/components/GridSpan/GridSpanColumns.tsx +38 -0
  149. package/templates/blocks/components/HStack/HStackBasic.doc.mjs +14 -0
  150. package/templates/blocks/components/HStack/HStackBasic.tsx +16 -0
  151. package/templates/blocks/components/Hooks/useKeyboardHintHookUsage.doc.mjs +14 -0
  152. package/templates/blocks/components/Hooks/useKeyboardHintHookUsage.tsx +57 -0
  153. package/templates/blocks/components/HoverCard/HoverCardInteractiveContent.doc.mjs +1 -1
  154. package/templates/blocks/components/HoverCard/HoverCardInteractiveContent.tsx +9 -4
  155. package/templates/blocks/components/InputGroup/InputGroupBasic.doc.mjs +14 -0
  156. package/templates/blocks/components/InputGroup/InputGroupBasic.tsx +27 -0
  157. package/templates/blocks/components/LayoutContent/LayoutContentBasic.doc.mjs +23 -0
  158. package/templates/blocks/components/LayoutContent/LayoutContentBasic.tsx +40 -0
  159. package/templates/blocks/components/LayoutFooter/LayoutFooterActions.doc.mjs +22 -0
  160. package/templates/blocks/components/LayoutFooter/LayoutFooterActions.tsx +41 -0
  161. package/templates/blocks/components/LayoutHeader/LayoutHeaderWithActions.doc.mjs +23 -0
  162. package/templates/blocks/components/LayoutHeader/LayoutHeaderWithActions.tsx +40 -0
  163. package/templates/blocks/components/LayoutPanel/LayoutPanelNavigation.doc.mjs +22 -0
  164. package/templates/blocks/components/LayoutPanel/LayoutPanelNavigation.tsx +37 -0
  165. package/templates/blocks/components/Lightbox/LightboxGallery.doc.mjs +14 -0
  166. package/templates/blocks/components/Lightbox/LightboxGallery.tsx +53 -0
  167. package/templates/blocks/components/Lightbox/LightboxShowcase.tsx +4 -3
  168. package/templates/blocks/components/Lightbox/LightboxVideo.doc.mjs +14 -0
  169. package/templates/blocks/components/Lightbox/LightboxVideo.tsx +27 -0
  170. package/templates/blocks/components/Lightbox/LightboxZoom.doc.mjs +14 -0
  171. package/templates/blocks/components/Lightbox/LightboxZoom.tsx +33 -0
  172. package/templates/blocks/components/LinkProvider/LinkProviderCustomLink.doc.mjs +1 -1
  173. package/templates/blocks/components/MetadataListItem/MetadataListItemBasic.doc.mjs +14 -0
  174. package/templates/blocks/components/MetadataListItem/MetadataListItemBasic.tsx +19 -0
  175. package/templates/blocks/components/MobileNavToggle/MobileNavToggleBasic.doc.mjs +23 -0
  176. package/templates/blocks/components/MobileNavToggle/MobileNavToggleBasic.tsx +42 -0
  177. package/templates/blocks/components/MoreMenu/MoreMenuShowcase.tsx +0 -6
  178. package/templates/blocks/components/NavIcon/NavIconBasic.doc.mjs +14 -0
  179. package/templates/blocks/components/NavIcon/NavIconBasic.tsx +16 -0
  180. package/templates/blocks/components/RadioListItem/RadioListItemBasic.doc.mjs +14 -0
  181. package/templates/blocks/components/RadioListItem/RadioListItemBasic.tsx +30 -0
  182. package/templates/blocks/components/Resizable/ResizableSidebar.doc.mjs +25 -0
  183. package/templates/blocks/components/Resizable/ResizableSidebar.tsx +67 -0
  184. package/templates/blocks/components/SegmentedControlItem/SegmentedControlItemBasic.doc.mjs +14 -0
  185. package/templates/blocks/components/SegmentedControlItem/SegmentedControlItemBasic.tsx +21 -0
  186. package/templates/blocks/components/SelectorOption/SelectorOptionBasic.doc.mjs +14 -0
  187. package/templates/blocks/components/SelectorOption/SelectorOptionBasic.tsx +39 -0
  188. package/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonBasic.doc.mjs +14 -0
  189. package/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonBasic.tsx +55 -0
  190. package/templates/blocks/components/SideNavHeading/SideNavHeadingBasic.doc.mjs +14 -0
  191. package/templates/blocks/components/SideNavHeading/SideNavHeadingBasic.tsx +38 -0
  192. package/templates/blocks/components/SideNavItem/SideNavItemBasic.doc.mjs +14 -0
  193. package/templates/blocks/components/SideNavItem/SideNavItemBasic.tsx +49 -0
  194. package/templates/blocks/components/SideNavSection/SideNavSectionBasic.doc.mjs +14 -0
  195. package/templates/blocks/components/SideNavSection/SideNavSectionBasic.tsx +71 -0
  196. package/templates/blocks/components/StackItem/StackItemFill.doc.mjs +14 -0
  197. package/templates/blocks/components/StackItem/StackItemFill.tsx +28 -0
  198. package/templates/blocks/components/Tab/TabWithSelectedIcon.doc.mjs +13 -0
  199. package/templates/blocks/components/Tab/TabWithSelectedIcon.tsx +39 -0
  200. package/templates/blocks/components/TabList/TabListTabsWithActions.doc.mjs +1 -1
  201. package/templates/blocks/components/TabMenu/TabMenuBasic.doc.mjs +14 -0
  202. package/templates/blocks/components/TabMenu/TabMenuBasic.tsx +23 -0
  203. package/templates/blocks/components/Table/StickyColumnsHookUsage.doc.mjs +1 -1
  204. package/templates/blocks/components/Table/TableRowExpansionTable.doc.mjs +14 -0
  205. package/templates/blocks/components/Table/TableRowExpansionTable.tsx +99 -0
  206. package/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupVertical.doc.mjs +14 -0
  207. package/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupVertical.tsx +47 -0
  208. package/templates/blocks/components/TopNavHeading/TopNavHeadingBasic.doc.mjs +14 -0
  209. package/templates/blocks/components/TopNavHeading/TopNavHeadingBasic.tsx +22 -0
  210. package/templates/blocks/components/TopNavItem/TopNavItemBasic.doc.mjs +14 -0
  211. package/templates/blocks/components/TopNavItem/TopNavItemBasic.tsx +21 -0
  212. package/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuBasic.doc.mjs +20 -0
  213. package/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuBasic.tsx +46 -0
  214. package/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardBasic.doc.mjs +14 -0
  215. package/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardBasic.tsx +16 -0
  216. package/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemBasic.doc.mjs +14 -0
  217. package/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemBasic.tsx +26 -0
  218. package/templates/blocks/components/TopNavMenu/TopNavMenuBasic.doc.mjs +14 -0
  219. package/templates/blocks/components/TopNavMenu/TopNavMenuBasic.tsx +43 -0
  220. package/templates/blocks/components/TypeaheadItem/TypeaheadItemBasic.doc.mjs +14 -0
  221. package/templates/blocks/components/TypeaheadItem/TypeaheadItemBasic.tsx +43 -0
  222. package/templates/blocks/components/VStack/VStackBasic.doc.mjs +14 -0
  223. package/templates/blocks/components/VStack/VStackBasic.tsx +20 -0
  224. package/templates/pages/kanban-board/page.tsx +729 -0
  225. package/templates/pages/kanban-board/template.doc.mjs +12 -0
  226. package/templates/pages/shell-nav/page.tsx +321 -0
  227. package/templates/pages/shell-nav/template.doc.mjs +12 -0
  228. package/templates/pages/shell-side-nav/page.tsx +241 -0
  229. package/templates/pages/shell-side-nav/template.doc.mjs +12 -0
  230. package/templates/pages/shell-top-nav/page.tsx +224 -0
  231. package/templates/pages/shell-top-nav/template.doc.mjs +12 -0
  232. package/templates/themes/stone/stoneTheme.ts +3 -3
  233. package/src/codemods/transforms/v0.1.0/__tests__/migrate-xds-config-surfaces.test.mjs +0 -116
  234. package/src/codemods/transforms/v0.1.0/migrate-xds-config-surfaces.mjs +0 -230
  235. package/src/commands/gap-report.mjs +0 -464
  236. package/src/commands/gap-report.test.mjs +0 -168
  237. package/src/commands/swizzle-gap-safety.test.mjs +0 -273
  238. package/src/lib/config.mjs +0 -113
  239. package/src/lib/config.test.mjs +0 -91
  240. package/src/types/gap-report.d.ts +0 -29
  241. package/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs +0 -14
  242. package/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.tsx +0 -64
  243. package/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs +0 -14
  244. package/templates/blocks/components/TreeListItem/TreeListItemShowcase.tsx +0 -60
  245. /package/src/codemods/transforms/{v0.0.15 → v0.1.0}/__tests__/drop-xds-prefix-imports.test.mjs +0 -0
@@ -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
+ }