@astryxdesign/cli 0.6.3-canary.ea2f048 → 0.6.3-canary.ee13359
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.
- package/README.md +114 -76
- package/api/blog/blog.doc.mjs +1 -0
- package/api/build/build.doc.mjs +4 -3
- package/api/build/build.test.mjs +14 -3
- package/api/build/build.type.d.mts +36 -2
- package/api/build/build.type.mjs +25 -4
- package/api/build/help/help.d.mts +8 -5
- package/api/build/help/help.mjs +56 -6
- package/api/component/_adapter.d.mts +6 -12
- package/api/component/_adapter.mjs +20 -10
- package/api/component/component.doc.mjs +13 -3
- package/api/component/component.mjs +91 -14
- package/api/component/component.test.mjs +38 -0
- package/api/component/component.type.d.mts +22 -11
- package/api/component/component.type.mjs +32 -24
- package/api/component/detail/blocks/blocks.d.mts +2 -1
- package/api/component/detail/blocks/blocks.mjs +4 -3
- package/api/component/list/list.d.mts +0 -5
- package/api/component/list/list.mjs +40 -11
- package/api/discover/discover.doc.mjs +2 -1
- package/api/discover/discover.type.d.mts +4 -4
- package/api/discover/discover.type.mjs +10 -10
- package/api/docs/_adapter.d.mts +230 -41
- package/api/docs/_adapter.mjs +734 -108
- package/api/docs/compiled-topics.test.mjs +78 -0
- package/api/docs/detail/detail.mjs +22 -63
- package/api/docs/detail/section/section.d.mts +1 -1
- package/api/docs/detail/section/section.mjs +54 -19
- package/api/docs/detail/section/section.test.mjs +50 -0
- package/api/docs/docs.d.mts +10 -3
- package/api/docs/docs.doc.mjs +54 -16
- package/api/docs/docs.mjs +53 -10
- package/api/docs/docs.test.mjs +164 -4
- package/api/docs/docs.type.d.mts +205 -5
- package/api/docs/docs.type.mjs +137 -11
- package/api/docs/index/index.d.mts +18 -0
- package/api/docs/index/index.mjs +40 -0
- package/api/docs/index/index.test.mjs +62 -0
- package/api/docs/integration-tree.test.mjs +547 -0
- package/api/docs/integrationDocs.test.mjs +114 -8
- package/api/docs/list/list.mjs +28 -12
- package/api/docs/node/node.d.mts +43 -0
- package/api/docs/node/node.mjs +192 -0
- package/api/doctor/doctor.d.mts +99 -1
- package/api/doctor/doctor.doc.mjs +1 -0
- package/api/doctor/doctor.mjs +544 -1
- package/api/doctor/doctor.test.mjs +610 -1
- package/api/gap-report/gap-report.doc.mjs +8 -4
- package/api/hook/_adapter.mjs +19 -5
- package/api/hook/hook.doc.mjs +1 -0
- package/api/hook/hook.type.d.mts +3 -3
- package/api/hook/hook.type.mjs +11 -11
- package/api/hook/list/list.d.mts +2 -2
- package/api/hook/list/list.mjs +69 -17
- package/api/index.d.mts +1 -1
- package/api/index.mjs +1 -0
- package/api/init/init.doc.mjs +6 -1
- package/api/init/init.test.mjs +41 -1
- package/api/init/remove/remove.mjs +1 -1
- package/api/init/run/run.mjs +20 -10
- package/api/integration/add-contribution.component-names.test.mjs +120 -0
- package/api/integration/add-contribution.d.mts +2 -1
- package/api/integration/add-contribution.mjs +130 -15
- package/api/integration/add-contribution.test.mjs +258 -7
- package/api/integration/add-theme.mjs +34 -64
- package/api/integration/add-theme.test.mjs +105 -21
- package/api/integration/authoring-checks.mjs +108 -31
- package/api/integration/authoring-checks.test.mjs +171 -6
- package/api/integration/authoring-checks.type.d.mts +3 -1
- package/api/integration/authoring-checks.type.mjs +3 -1
- package/api/integration/integration-authoring.type.d.mts +3 -1
- package/api/integration/integration-authoring.type.mjs +2 -0
- package/api/integration/integration-block-exports.test.mjs +10 -6
- package/api/integration/integrationAdd.doc.mjs +14 -4
- package/api/integration/integrationAddAgentDoc.doc.mjs +1 -0
- package/api/integration/integrationAddCodemod.doc.mjs +1 -0
- package/api/integration/integrationAddComponent.doc.mjs +2 -1
- package/api/integration/integrationAddDoc.doc.mjs +8 -1
- package/api/integration/integrationAddTemplate.doc.mjs +1 -0
- package/api/integration/integrationAddTheme.doc.mjs +6 -5
- package/api/integration/integrationComponentConflicts.doc.mjs +1 -0
- package/api/integration/integrationDocConflicts.doc.mjs +2 -1
- package/api/integration/integrationPackCheck.doc.mjs +2 -1
- package/api/integration/integrationTemplateConflicts.doc.mjs +7 -5
- package/api/integration/pack-check.mjs +83 -7
- package/api/integration/pack-check.test.mjs +387 -47
- package/api/integration/pack-check.type.d.mts +26 -2
- package/api/integration/pack-check.type.mjs +14 -1
- package/api/integration/summarizeIssues.doc.mjs +1 -0
- package/api/integration/validate-integration-fixes.test.mjs +1389 -0
- package/api/integration/validate-integration.mjs +52 -102
- package/api/integration/validate-integration.test.mjs +179 -26
- package/api/integration/validate-unread-theme-folders.test.mjs +110 -0
- package/api/integration/validateIntegration.doc.mjs +3 -2
- package/api/json/assertResponse.doc.mjs +1 -0
- package/api/json/envelope-types.test.mjs +76 -0
- package/api/json/index.ts +2 -0
- package/api/json/isError.doc.mjs +1 -0
- package/api/json/parseResponse.doc.mjs +3 -2
- package/api/layout/_adapter.mjs +20 -5
- package/api/layout/expand/expand.mjs +7 -5
- package/api/layout/expand/expand.path-safety.test.mjs +53 -0
- package/api/layout/grammar/grammar.mjs +2 -1
- package/api/layout/layoutCheck.doc.mjs +1 -0
- package/api/layout/layoutExpand.doc.mjs +2 -1
- package/api/layout/layoutGrammar.doc.mjs +1 -0
- package/api/search/search-return-type.test.mjs +54 -0
- package/api/search/search.d.mts +29 -11
- package/api/search/search.doc.mjs +8 -2
- package/api/search/search.mjs +337 -41
- package/api/search/search.test.mjs +124 -1
- package/api/search/search.type.d.mts +15 -3
- package/api/search/search.type.mjs +5 -2
- package/api/swizzle/copy/copy.mjs +28 -11
- package/api/swizzle/swizzle.doc.mjs +2 -1
- package/api/swizzle/swizzle.type.d.mts +2 -2
- package/api/swizzle/swizzle.type.mjs +2 -2
- package/api/template/copy/copy.mjs +17 -23
- package/api/template/copy/copy.test.mjs +17 -0
- package/api/template/list/list.mjs +1 -0
- package/api/template/template-integration.test.mjs +1022 -3
- package/api/template/template-suffix.test.mjs +41 -21
- package/api/template/template.d.mts +1 -1
- package/api/template/template.doc.mjs +30 -8
- package/api/template/template.mjs +45 -8
- package/api/template/template.type.d.mts +12 -14
- package/api/template/template.type.mjs +15 -14
- package/api/theme/_adapter.d.mts +2 -3
- package/api/theme/_adapter.mjs +4 -5
- package/api/theme/add/add.binary.test.mjs +84 -0
- package/api/theme/add/add.mjs +20 -3
- package/api/theme/add/add.staging.test.mjs +66 -0
- package/api/theme/add/add.test.mjs +14 -1
- package/api/theme/build/build.mjs +133 -42
- package/api/theme/build/build.public-component-vars.test.mjs +1 -1
- package/api/theme/build/build.receipt-doc.test.mjs +111 -0
- package/api/theme/build/build.test.mjs +127 -0
- package/api/theme/build/font-warning.mjs +3 -3
- package/api/theme/build/font-warning.test.mjs +5 -2
- package/api/theme/generateTonalPalette.doc.mjs +1 -0
- package/api/theme/integration-themes.test.mjs +39 -28
- package/api/theme/list/list.test.mjs +19 -20
- package/api/theme/listThemes.doc.mjs +6 -5
- package/api/theme/palette/generate/generate.mjs +8 -3
- package/api/theme/palette/generate/generate.test.mjs +96 -0
- package/api/theme/palette/generate/generator.d.mts +10 -13
- package/api/theme/palette/generate/generator.mjs +15 -4
- package/api/theme/palette/generate/generator.test.mjs +10 -0
- package/api/theme/template/template.mjs +11 -2
- package/api/theme/template/template.test.mjs +20 -0
- package/api/theme/theme.type.d.mts +170 -11
- package/api/theme/theme.type.mjs +94 -27
- package/api/theme/themeAdd.doc.mjs +4 -3
- package/api/theme/themeBuild.doc.mjs +8 -4
- package/api/theme/themeList.doc.mjs +6 -3
- package/api/theme/themeListAvailable.doc.mjs +5 -3
- package/api/theme/themePaletteGenerate.doc.mjs +1 -0
- package/api/theme/themeTargets.doc.mjs +1 -0
- package/api/theme/themeTemplate.doc.mjs +6 -2
- package/api/upgrade/_adapter.d.mts +32 -5
- package/api/upgrade/_adapter.mjs +139 -22
- package/api/upgrade/list/list.mjs +2 -1
- package/api/upgrade/list/list.test.mjs +73 -0
- package/api/upgrade/project-context.test.mjs +272 -0
- package/api/upgrade/provider-agreement.test.mjs +152 -0
- package/api/upgrade/run/run.mjs +356 -59
- package/api/upgrade/status/status.mjs +2 -2
- package/api/upgrade/upgrade.doc.mjs +12 -5
- package/api/upgrade/upgrade.type.d.mts +43 -5
- package/api/upgrade/upgrade.type.mjs +27 -11
- package/assets/codemods/__tests__/runner.test.mjs +330 -8
- package/assets/codemods/integration-discovery.mjs +48 -4
- package/assets/codemods/integration-discovery.test.mjs +73 -0
- package/assets/codemods/integration-runner.mjs +56 -4
- package/assets/codemods/integration-runner.protection.test.mjs +153 -0
- package/assets/codemods/run-codemod.mjs +177 -34
- package/assets/codemods/runner.mjs +350 -102
- package/assets/codemods/term-log.mjs +32 -8
- package/assets/codemods/term-log.test.mjs +19 -1
- package/assets/codemods/transform-prop.mjs +109 -0
- package/assets/codemods/transform-prop.test.mjs +95 -0
- package/assets/codemods/transforms/next/__tests__/migrate-native-picker-to-presentation.test.mjs +63 -0
- package/assets/codemods/transforms/next/__tests__/migrate-theme-catalog-to-descriptors.test.mjs +220 -0
- package/assets/codemods/transforms/next/index.mjs +19 -1
- package/assets/codemods/transforms/next/migrate-native-picker-to-presentation.mjs +148 -0
- package/assets/codemods/transforms/next/migrate-theme-catalog-to-descriptors.mjs +141 -0
- package/assets/codemods/transforms/v0.0.14/__tests__/rename-status-variants.test.mjs +86 -165
- package/assets/codemods/transforms/v0.0.14/rename-status-variants.mjs +72 -210
- package/assets/codemods/transforms/v0.1.8/__tests__/rename-avatar-size-scale.test.mjs +83 -115
- package/assets/codemods/transforms/v0.1.8/rename-avatar-size-scale.mjs +57 -186
- package/assets/codemods/transforms/v0.3.0/__tests__/unwrap-authoring-factories.test.mjs +27 -5
- package/assets/codemods/transforms/v0.3.0/unwrap-authoring-factories.mjs +20 -5
- package/assets/codemods/transforms/v0.6.0/__tests__/next-codemods.test.mjs +47 -0
- package/assets/codemods/transforms/v0.6.0/rename-resizable-pixel-bounds.mjs +57 -10
- package/assets/docs/README.md +9 -0
- package/assets/docs/authoring.doc.mjs +14 -0
- package/assets/docs/getting-started.doc.mjs +2 -2
- package/assets/docs/principles.doc.mjs +6 -6
- package/assets/docs/styling-libraries.doc.mjs +3 -3
- package/assets/docs/styling.doc.mjs +4 -4
- package/assets/docs/theme.doc.mjs +4 -4
- package/assets/docs/tokens.doc.mjs +1 -1
- package/assets/docs/tree/api.doc.mjs +30 -0
- package/assets/docs/tree/cli.doc.mjs +23 -0
- package/assets/docs/tree/commands.doc.mjs +25 -0
- package/assets/docs/{cli-integrations.doc.mjs → tree/integrations.doc.mjs} +124 -25
- package/assets/docs/tree/integrations.test.mjs +62 -0
- package/assets/docs/tree/writing-docs.doc.mjs +286 -0
- package/assets/docs/working-with-ai.doc.mjs +1 -1
- package/assets/templates/blocks/components/DateInput/DateInputDateRange.tsx +1 -1
- package/assets/templates/blocks/components/Item/ItemDocumentTabs.doc.mjs +14 -0
- package/assets/templates/blocks/components/Item/ItemDocumentTabs.tsx +100 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.doc.mjs +14 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaInlineRail.tsx +61 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.doc.mjs +14 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaOverscrollChaining.tsx +126 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.doc.mjs +15 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaShowcase.tsx +86 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.doc.mjs +14 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyGroupHeaders.tsx +99 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.doc.mjs +14 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.tsx +122 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.doc.mjs +14 -0
- package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.tsx +95 -0
- package/assets/templates/blocks/components/TimeInput/TimeInputConstrained.tsx +1 -0
- package/assets/templates/pages/table-tree/page.tsx +1704 -0
- package/assets/templates/pages/table-tree/template.doc.mjs +12 -0
- package/assets/templates/themes/butter/butterTheme.doc.mjs +11 -0
- package/assets/templates/themes/chocolate/chocolateTheme.doc.mjs +11 -0
- package/assets/templates/themes/gothic/gothicTheme.doc.mjs +11 -0
- package/assets/templates/themes/matcha/matchaTheme.doc.mjs +11 -0
- package/assets/templates/themes/neutral/neutralTheme.doc.mjs +11 -0
- package/assets/templates/themes/stone/stoneTheme.doc.mjs +11 -0
- package/assets/templates/themes/y2k/y2kTheme.doc.mjs +11 -0
- package/authoring/_shared/contract.ts +22 -0
- package/authoring/codemod/codemod.doc.mjs +7 -2
- package/authoring/codemod/parse.d.mts +8 -8
- package/authoring/codemod/parse.mjs +8 -6
- package/authoring/codemod/type.ts +12 -0
- package/authoring/config/config.doc.mjs +2 -2
- package/authoring/config/debug-composition.test.mjs +92 -0
- package/authoring/config/parse.d.mts +13 -13
- package/authoring/config/parse.mjs +8 -8
- package/authoring/config/type.ts +18 -6
- package/authoring/debug/debug.doc.d.mts +11 -0
- package/authoring/debug/debug.doc.mjs +182 -0
- package/authoring/debug/parse.d.mts +8 -8
- package/authoring/debug/parse.mjs +3 -3
- package/authoring/doctypes/_schema.d.mts +718 -23
- package/authoring/doctypes/_schema.mjs +519 -39
- package/authoring/doctypes/base/graph-fields.doc.d.mts +9 -0
- package/authoring/doctypes/base/graph-fields.doc.mjs +64 -0
- package/authoring/doctypes/base/type.ts +41 -0
- package/authoring/doctypes/command/command.doc.mjs +4 -3
- package/authoring/doctypes/command/parse.d.mts +2 -2
- package/authoring/doctypes/command/parse.mjs +1 -1
- package/authoring/doctypes/command/type.ts +5 -4
- package/authoring/doctypes/component/component.doc.mjs +6 -3
- package/authoring/doctypes/component/parse.d.mts +2 -2
- package/authoring/doctypes/component/parse.mjs +1 -1
- package/authoring/doctypes/component/type.ts +6 -5
- package/authoring/doctypes/doctypes-new.test.mjs +48 -6
- package/authoring/doctypes/enum/enum.doc.mjs +1 -1
- package/authoring/doctypes/enum/parse.d.mts +2 -2
- package/authoring/doctypes/enum/parse.mjs +1 -1
- package/authoring/doctypes/enum/type.ts +4 -2
- package/authoring/doctypes/function/function.doc.mjs +7 -2
- package/authoring/doctypes/function/parse.d.mts +2 -2
- package/authoring/doctypes/function/parse.mjs +1 -1
- package/authoring/doctypes/function/type.ts +9 -4
- package/authoring/doctypes/hook/hook.doc.mjs +4 -0
- package/authoring/doctypes/hook/parse.d.mts +2 -2
- package/authoring/doctypes/hook/parse.mjs +1 -1
- package/authoring/doctypes/hook/type.ts +5 -4
- package/authoring/doctypes/legacy.d.mts +8 -6
- package/authoring/doctypes/legacy.mjs +5 -4
- package/authoring/doctypes/load-contract.test.mjs +208 -0
- package/authoring/doctypes/namespace/namespace.doc.d.mts +9 -0
- package/authoring/doctypes/namespace/namespace.doc.mjs +128 -0
- package/authoring/doctypes/namespace/parse.d.mts +12 -0
- package/authoring/doctypes/namespace/parse.mjs +25 -0
- package/authoring/doctypes/namespace/parse.test.mjs +163 -0
- package/authoring/doctypes/namespace/type.ts +74 -0
- package/authoring/doctypes/parse.d.mts +22 -18
- package/authoring/doctypes/parse.mjs +22 -11
- package/authoring/doctypes/parse.test.mjs +77 -3
- package/authoring/doctypes/reference/parse.d.mts +2 -2
- package/authoring/doctypes/reference/parse.mjs +8 -5
- package/authoring/doctypes/reference/reference.doc.mjs +20 -5
- package/authoring/doctypes/reference/type.ts +53 -5
- package/authoring/doctypes/schema/parse.d.mts +2 -2
- package/authoring/doctypes/schema/parse.mjs +1 -1
- package/authoring/doctypes/schema/schema.doc.mjs +1 -1
- package/authoring/doctypes/schema/type.ts +4 -4
- package/authoring/doctypes/template/parse.d.mts +94 -1
- package/authoring/doctypes/template/parse.mjs +40 -2
- package/authoring/doctypes/template/parse.test.mjs +26 -2
- package/authoring/doctypes/template/template.doc.mjs +13 -3
- package/authoring/doctypes/template/type.ts +13 -2
- package/authoring/doctypes/theme/parse.d.mts +35 -0
- package/authoring/doctypes/theme/parse.mjs +76 -0
- package/authoring/doctypes/theme/theme.doc.d.mts +9 -0
- package/authoring/doctypes/theme/theme.doc.mjs +79 -0
- package/authoring/doctypes/theme/type.ts +42 -0
- package/authoring/doctypes/types.ts +12 -10
- package/authoring/gap-report/gap-report.doc.d.mts +12 -0
- package/authoring/gap-report/gap-report.doc.mjs +183 -0
- package/authoring/gap-report/parse.d.mts +10 -10
- package/authoring/gap-report/parse.mjs +6 -6
- package/authoring/gap-report/type.ts +1 -1
- package/authoring/identity/identity.doc.d.mts +9 -0
- package/authoring/identity/identity.doc.mjs +61 -0
- package/authoring/identity/type.ts +132 -0
- package/authoring/index.d.mts +2 -0
- package/authoring/index.d.ts +52 -17
- package/authoring/index.mjs +3 -1
- package/authoring/integration/integration.doc.mjs +15 -8
- package/authoring/integration/parse.d.mts +2 -2
- package/authoring/integration/parse.mjs +1 -1
- package/authoring/integration/parse.test.mjs +10 -1
- package/authoring/integration/schema.d.mts +6 -4
- package/authoring/integration/schema.mjs +9 -3
- package/authoring/integration/type.ts +19 -8
- package/authoring/shadcn/receipt.d.mts +6 -6
- package/clients/cli/__tests__/cliManifest.test.ts +27 -29
- package/clients/cli/command-load-failure.test.mjs +83 -0
- package/clients/cli/commands/blog.doc.mjs +1 -1
- package/clients/cli/commands/blog.mjs +23 -8
- package/clients/cli/commands/blog.test.mjs +42 -1
- package/clients/cli/commands/build-theme.adaptations.test.mjs +100 -1
- package/clients/cli/commands/build-theme.ascii-output.test.mjs +161 -0
- package/clients/cli/commands/build-theme.flag-docs.test.mjs +110 -0
- package/clients/cli/commands/build-theme.mjs +16 -50
- package/clients/cli/commands/build-theme.path-safety.test.mjs +86 -1
- package/clients/cli/commands/build-theme.variants.test.mjs +76 -0
- package/clients/cli/commands/build.doc.mjs +5 -2
- package/clients/cli/commands/build.exit-codes-doc.test.mjs +50 -0
- package/clients/cli/commands/build.mjs +37 -49
- package/clients/cli/commands/build.playbook.test.mjs +75 -0
- package/clients/cli/commands/build.text-fields.test.mjs +40 -0
- package/clients/cli/commands/component/index.mjs +3 -8
- package/clients/cli/commands/component-ownership.test.mjs +3 -3
- package/clients/cli/commands/component-package.test.mjs +46 -0
- package/clients/cli/commands/component-resolution.test.mjs +21 -0
- package/clients/cli/commands/component.doc.mjs +1 -1
- package/clients/cli/commands/component.test.mjs +19 -0
- package/clients/cli/commands/detail-levels.test.mjs +2 -2
- package/clients/cli/commands/discover.broken-integration.test.mjs +52 -5
- package/clients/cli/commands/discover.components-flag.test.mjs +97 -0
- package/clients/cli/commands/discover.doc.mjs +5 -3
- package/clients/cli/commands/discover.mjs +4 -4
- package/clients/cli/commands/discover.text-projection.test.mjs +103 -0
- package/clients/cli/commands/docs.doc.mjs +28 -6
- package/clients/cli/commands/docs.mjs +238 -24
- package/clients/cli/commands/docs.test.mjs +193 -1
- package/clients/cli/commands/doctor-integration-components.doc.mjs +1 -1
- package/clients/cli/commands/doctor-integration-docs.doc.mjs +3 -3
- package/clients/cli/commands/doctor-integration-templates.doc.mjs +15 -8
- package/clients/cli/commands/doctor-integration-validate.doc.mjs +1 -1
- package/clients/cli/commands/doctor-integration.doc.mjs +1 -1
- package/clients/cli/commands/doctor-integration.package-json.test.mjs +53 -0
- package/clients/cli/commands/doctor-integration.test.mjs +83 -8
- package/clients/cli/commands/doctor.doc.mjs +1 -1
- package/clients/cli/commands/doctor.mjs +30 -25
- package/clients/cli/commands/doctor.test.mjs +42 -0
- package/clients/cli/commands/gap-report.doc.mjs +17 -6
- package/clients/cli/commands/gap-report.test.mjs +72 -0
- package/clients/cli/commands/hook/index.mjs +7 -17
- package/clients/cli/commands/hook.doc.mjs +1 -1
- package/clients/cli/commands/hook.text-projection.test.mjs +45 -0
- package/clients/cli/commands/init.doc.mjs +20 -9
- package/clients/cli/commands/init.flag-help.test.mjs +153 -0
- package/clients/cli/commands/integration-add.controls.test.mjs +132 -0
- package/clients/cli/commands/integration-add.doc.mjs +32 -6
- package/clients/cli/commands/integration-authoring.test.mjs +13 -9
- package/clients/cli/commands/integration-pack.doc.mjs +1 -1
- package/clients/cli/commands/integration-real-world.test.mjs +3 -9
- package/clients/cli/commands/integration.doc.mjs +1 -1
- package/clients/cli/commands/integration.mjs +1 -0
- package/clients/cli/commands/interactive-guard.test.mjs +101 -24
- package/clients/cli/commands/json-contract.test.mjs +33 -0
- package/clients/cli/commands/layout-check.doc.mjs +15 -4
- package/clients/cli/commands/layout-expand.doc.mjs +22 -5
- package/clients/cli/commands/layout-grammar.doc.mjs +1 -1
- package/clients/cli/commands/layout.doc.mjs +3 -3
- package/clients/cli/commands/layout.mjs +21 -9
- package/clients/cli/commands/layout.path-help.test.mjs +33 -0
- package/clients/cli/commands/layout.stdin-cap.test.mjs +47 -0
- package/clients/cli/commands/layout.text-fields.test.mjs +39 -0
- package/clients/cli/commands/manifest.doc.mjs +1 -1
- package/clients/cli/commands/no-prompt-wording.test.mjs +94 -0
- package/clients/cli/commands/search.doc.mjs +7 -4
- package/clients/cli/commands/search.mjs +28 -9
- package/clients/cli/commands/search.test.mjs +75 -0
- package/clients/cli/commands/setup-nudge.test.mjs +6 -0
- package/clients/cli/commands/swizzle.doc.mjs +3 -2
- package/clients/cli/commands/swizzle.path-safety.test.mjs +42 -0
- package/clients/cli/commands/template.doc.mjs +52 -13
- package/clients/cli/commands/template.flag-help.test.mjs +117 -0
- package/clients/cli/commands/template.mjs +4 -91
- package/clients/cli/commands/template.path-help.test.mjs +40 -0
- package/clients/cli/commands/text-json-parity.test.mjs +719 -0
- package/clients/cli/commands/theme-add.doc.mjs +4 -3
- package/clients/cli/commands/theme-build.doc.mjs +8 -7
- package/clients/cli/commands/theme-list.doc.mjs +2 -2
- package/clients/cli/commands/theme-palette-generate.doc.mjs +9 -5
- package/clients/cli/commands/theme-palette-generate.test.mjs +19 -0
- package/clients/cli/commands/theme-palette.doc.mjs +1 -1
- package/clients/cli/commands/theme-targets.behavior.test.mjs +4 -3
- package/clients/cli/commands/theme-targets.doc.mjs +1 -1
- package/clients/cli/commands/theme-template.behavior.test.mjs +12 -0
- package/clients/cli/commands/theme-template.doc.mjs +2 -2
- package/clients/cli/commands/theme.doc.mjs +1 -1
- package/clients/cli/commands/upgrade.ascii-output.test.mjs +87 -0
- package/clients/cli/commands/upgrade.doc.mjs +22 -10
- package/clients/cli/commands/upgrade.file-protection.test.mjs +228 -0
- package/clients/cli/commands/upgrade.flag-help.test.mjs +188 -0
- package/clients/cli/commands/upgrade.hook-output.test.mjs +88 -0
- package/clients/cli/commands/upgrade.mjs +29 -7
- package/clients/cli/formatters/index.mjs +164 -1
- package/clients/cli/formatters/index.test.mjs +97 -0
- package/clients/cli/index.mjs +21 -30
- package/clients/cli/latest-version-env.test.mjs +50 -0
- package/clients/cli/lib/cli-error.test.mjs +7 -0
- package/clients/cli/lib/component-format.mjs +9 -9
- package/clients/cli/lib/component-format.test.mjs +1 -1
- package/clients/cli/lib/define-command.mjs +32 -6
- package/clients/cli/lib/doc-text-ascii.test.mjs +82 -0
- package/clients/cli/lib/exit-codes.test.mjs +97 -0
- package/clients/cli/lib/hook-format.mjs +19 -10
- package/clients/cli/lib/json-shim.mjs +38 -2
- package/clients/cli/lib/json-shim.test.mjs +83 -0
- package/clients/cli/lib/manifest.d.ts +2 -0
- package/clients/cli/lib/manifest.mjs +36 -2
- package/clients/cli/lib/manifest.test.mjs +17 -0
- package/foundation/agent-docs/agent-docs.d.mts +4 -0
- package/foundation/agent-docs/agent-docs.mjs +70 -3
- package/foundation/agent-docs/agent-docs.path-safety.test.mjs +266 -4
- package/foundation/agent-docs/agent-docs.test.mjs +10 -1
- package/foundation/config/integration-debug.test.mjs +28 -3
- package/foundation/config/project-themes.test.mjs +11 -19
- package/foundation/config/project.d.mts +20 -11
- package/foundation/config/project.mjs +263 -91
- package/foundation/config/project.test.mjs +270 -21
- package/foundation/discovery/authoring-self-docs.d.mts +75 -0
- package/foundation/discovery/authoring-self-docs.mjs +224 -0
- package/foundation/discovery/authoring-self-docs.test.mjs +165 -0
- package/foundation/discovery/authoring-surface.d.mts +74 -0
- package/foundation/discovery/authoring-surface.mjs +525 -0
- package/foundation/discovery/authoring-surface.test.mjs +392 -0
- package/foundation/discovery/cli-self-docs.d.mts +119 -0
- package/foundation/discovery/cli-self-docs.mjs +490 -0
- package/foundation/discovery/cli-self-docs.test.mjs +375 -0
- package/foundation/discovery/component-discovery.d.mts +39 -1
- package/foundation/discovery/component-discovery.mjs +50 -1
- package/foundation/discovery/component-loader.d.mts +35 -38
- package/foundation/discovery/component-loader.mjs +53 -222
- package/foundation/discovery/docs-discovery.d.mts +116 -11
- package/foundation/discovery/docs-discovery.mjs +389 -108
- package/foundation/discovery/docs-discovery.test.mjs +325 -20
- package/foundation/discovery/docs-output-budget.d.mts +28 -0
- package/foundation/discovery/docs-output-budget.mjs +50 -0
- package/foundation/discovery/docs-section-key.d.mts +116 -0
- package/foundation/discovery/docs-section-key.mjs +322 -0
- package/foundation/discovery/docs-section-key.test.mjs +246 -0
- package/foundation/discovery/template-adapter.d.mts +113 -11
- package/foundation/discovery/template-adapter.fixture-refs.test.mjs +248 -0
- package/foundation/discovery/template-adapter.integration-isolation.test.mjs +94 -0
- package/foundation/discovery/template-adapter.mjs +774 -83
- package/foundation/discovery/template-adapter.test.mjs +57 -0
- package/foundation/discovery/theme-discovery.d.mts +67 -7
- package/foundation/discovery/theme-discovery.mjs +916 -186
- package/foundation/discovery/theme-discovery.test.mjs +613 -219
- package/foundation/discovery/theming-targets.test.mjs +4 -0
- package/foundation/doc-compiler/bundle.d.mts +47 -0
- package/foundation/doc-compiler/bundle.mjs +278 -0
- package/foundation/doc-compiler/bundle.test.mjs +266 -0
- package/foundation/doc-compiler/compile.d.mts +343 -0
- package/foundation/doc-compiler/compile.mjs +558 -0
- package/foundation/doc-compiler/diagnostics.d.mts +126 -0
- package/foundation/doc-compiler/diagnostics.mjs +305 -0
- package/foundation/doc-compiler/doc-compiler.test.mjs +714 -0
- package/foundation/doc-compiler/doc-loads.test.mjs +1642 -0
- package/foundation/doc-compiler/import.d.mts +24 -0
- package/foundation/doc-compiler/import.mjs +59 -0
- package/foundation/doc-compiler/inputs.d.mts +102 -0
- package/foundation/doc-compiler/inputs.mjs +291 -0
- package/foundation/doc-compiler/inputs.test.mjs +299 -0
- package/foundation/doc-compiler/ir.d.mts +22 -0
- package/foundation/doc-compiler/ir.mjs +471 -0
- package/foundation/doc-compiler/lenses.d.mts +34 -0
- package/foundation/doc-compiler/lenses.mjs +128 -0
- package/foundation/doc-compiler/links.d.mts +135 -0
- package/foundation/doc-compiler/links.mjs +253 -0
- package/foundation/doc-compiler/links.test.mjs +139 -0
- package/foundation/doc-compiler/lower-doc.test.mjs +495 -0
- package/foundation/doc-compiler/overlays.d.mts +37 -0
- package/foundation/doc-compiler/overlays.mjs +206 -0
- package/foundation/doc-compiler/parse-readable.d.mts +9 -0
- package/foundation/doc-compiler/parse-readable.mjs +29 -0
- package/foundation/doc-compiler/read.d.mts +127 -0
- package/foundation/doc-compiler/read.mjs +325 -0
- package/foundation/doc-compiler/read.test.mjs +313 -0
- package/foundation/doc-compiler/source.d.mts +33 -0
- package/foundation/doc-compiler/source.mjs +128 -0
- package/foundation/doc-compiler/tree.d.mts +288 -0
- package/foundation/doc-compiler/tree.mjs +876 -0
- package/foundation/doc-compiler/tree.test.mjs +598 -0
- package/foundation/fs/file-protection.d.mts +33 -0
- package/foundation/fs/file-protection.mjs +825 -0
- package/foundation/fs/file-protection.test.mjs +250 -0
- package/foundation/fs/module-loader.d.mts +1 -0
- package/foundation/fs/module-loader.mjs +50 -1
- package/foundation/fs/module-loader.stdout.test.mjs +332 -0
- package/foundation/fs/path-safety.d.mts +3 -2
- package/foundation/fs/path-safety.mjs +49 -19
- package/foundation/fs/path-safety.test.mjs +50 -0
- package/foundation/fs/publish-file-hardlink-unavailable.test.mjs +129 -94
- package/foundation/identity/provider-identity.d.mts +90 -0
- package/foundation/identity/provider-identity.mjs +320 -0
- package/foundation/identity/provider-identity.test.mjs +254 -0
- package/foundation/identity/providers.d.mts +7 -0
- package/foundation/identity/providers.mjs +16 -0
- package/foundation/integrations/autolink.d.mts +58 -1
- package/foundation/integrations/autolink.mjs +143 -45
- package/foundation/integrations/autolink.test.mjs +1 -1
- package/foundation/integrations/cli-requirement.d.mts +45 -0
- package/foundation/integrations/cli-requirement.mjs +154 -0
- package/foundation/integrations/cli-requirement.test.mjs +109 -0
- package/foundation/integrations/contribution-fixes.d.mts +145 -0
- package/foundation/integrations/contribution-fixes.mjs +1284 -0
- package/foundation/integrations/contribution-inventory.d.mts +3 -2
- package/foundation/integrations/contribution-inventory.mjs +27 -24
- package/foundation/integrations/contribution-inventory.test.mjs +86 -27
- package/foundation/integrations/integration-warnings.d.mts +9 -2
- package/foundation/integrations/integration-warnings.mjs +52 -21
- package/foundation/integrations/integration-warnings.test.mjs +74 -1
- package/foundation/integrations/integrations.d.mts +49 -2
- package/foundation/integrations/integrations.mjs +81 -8
- package/foundation/integrations/integrations.test.mjs +384 -1
- package/foundation/integrations/provider-conflicts.test.mjs +125 -0
- package/foundation/integrations/provider-ledger.test.mjs +275 -0
- package/foundation/integrations/provider-resolution.d.mts +152 -0
- package/foundation/integrations/provider-resolution.mjs +576 -0
- package/foundation/integrations/provider-resolution.test.mjs +369 -0
- package/foundation/integrations/theme-descriptor.d.mts +8 -0
- package/foundation/integrations/theme-descriptor.mjs +44 -0
- package/foundation/integrations/validate-contributions.d.mts +2 -0
- package/foundation/integrations/validate-contributions.mjs +131 -29
- package/foundation/response/base.d.ts +8 -4
- package/foundation/response/error-codes.d.mts +3 -1
- package/foundation/response/error-codes.d.ts +2 -0
- package/foundation/response/error-codes.doc.mjs +13 -4
- package/foundation/response/error-codes.mjs +8 -2
- package/foundation/response/error-codes.test.mjs +137 -10
- package/foundation/response/json-contract.test.mjs +57 -17
- package/foundation/response/json.d.mts +4 -2
- package/foundation/response/json.mjs +8 -10
- package/foundation/response/response-types.doc.mjs +26 -16
- package/foundation/response/response-types.doc.test.mjs +158 -0
- package/foundation/response/response.doc.mjs +1 -1
- package/foundation/text/string-utils.mjs +22 -10
- package/foundation/xle/expand.d.mts +2 -0
- package/foundation/xle/expand.mjs +4 -3
- package/foundation/xle/expand.test.mjs +54 -0
- package/foundation/xle/xle.test.mjs +13 -0
- package/package.json +10 -11
- package/assets/templates/themes/manifest.json +0 -95
- package/clients/cli/lib/update-check.mjs +0 -83
- package/clients/cli/lib/update-check.test.mjs +0 -137
- package/clients/cli/update-hint-commands.test.mjs +0 -54
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @file The CLI never asks a question, so no help text, manifest entry or
|
|
5
|
+
* error-code description may say a flag skips a prompt. Each flag's text states
|
|
6
|
+
* what happens without it instead, and the CLI does that.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import {describe, it, expect, beforeEach, afterEach} from 'vitest';
|
|
10
|
+
import * as fs from 'node:fs';
|
|
11
|
+
import * as os from 'node:os';
|
|
12
|
+
import * as path from 'node:path';
|
|
13
|
+
import {fileURLToPath} from 'node:url';
|
|
14
|
+
import {runCli} from '../../../test-utils/run-cli.mjs';
|
|
15
|
+
import {doc as errorCodesDoc} from '../../../foundation/response/error-codes.doc.mjs';
|
|
16
|
+
import {doc as upgradeFn} from '../../../api/upgrade/upgrade.doc.mjs';
|
|
17
|
+
|
|
18
|
+
const CLI_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
|
|
19
|
+
const SLOW = 30_000;
|
|
20
|
+
|
|
21
|
+
/** @type {string} */
|
|
22
|
+
let tmpDir;
|
|
23
|
+
|
|
24
|
+
beforeEach(() => {
|
|
25
|
+
tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-no-prompt-'));
|
|
26
|
+
fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({name: 'consumer'}));
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
afterEach(() => {
|
|
30
|
+
fs.rmSync(tmpDir, {recursive: true, force: true});
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* One option's description from the manifest (subcommands are nested).
|
|
35
|
+
* @param {string} command @param {string} flag
|
|
36
|
+
*/
|
|
37
|
+
async function optionText(command, flag) {
|
|
38
|
+
const {stdout} = await runCli(['--json', 'manifest'], tmpDir);
|
|
39
|
+
/** @typedef {{name: string, options: Array<{flag: string, description: string}>, subcommands?: ManifestCommand[]}} ManifestCommand */
|
|
40
|
+
/** @param {ManifestCommand[]} list @returns {ManifestCommand | undefined} */
|
|
41
|
+
const find = list => {
|
|
42
|
+
for (const c of list) {
|
|
43
|
+
const hit = c.name === command ? c : find(c.subcommands ?? []);
|
|
44
|
+
if (hit) return hit;
|
|
45
|
+
}
|
|
46
|
+
return undefined;
|
|
47
|
+
};
|
|
48
|
+
const cmd = find(JSON.parse(stdout).data.commands);
|
|
49
|
+
return cmd?.options.find(o => o.flag.includes(flag))?.description ?? '';
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
describe('no help text describes a prompt', () => {
|
|
53
|
+
it('theme add --overwrite states the refusal, and a refused run writes nothing', async () => {
|
|
54
|
+
const help = await optionText('theme add', '--overwrite');
|
|
55
|
+
expect(help).not.toMatch(/prompt/i);
|
|
56
|
+
expect(help).toContain('ERR_FILE_EXISTS');
|
|
57
|
+
expect(help).toMatch(/nothing is written/);
|
|
58
|
+
|
|
59
|
+
const first = await runCli(['--json', 'theme', 'add', 'matcha'], tmpDir);
|
|
60
|
+
expect(first.status).toBe(0);
|
|
61
|
+
const {outputDir, files} = JSON.parse(first.stdout).data;
|
|
62
|
+
expect(files.length).toBeGreaterThan(1);
|
|
63
|
+
const dir = path.join(tmpDir, outputDir);
|
|
64
|
+
fs.writeFileSync(path.join(dir, files[0]), '// edited\n');
|
|
65
|
+
fs.rmSync(path.join(dir, files[1]));
|
|
66
|
+
|
|
67
|
+
const refused = await runCli(['--json', 'theme', 'add', 'matcha'], tmpDir);
|
|
68
|
+
expect(refused.status).toBe(1);
|
|
69
|
+
expect(JSON.parse(refused.stdout).code).toBe('ERR_FILE_EXISTS');
|
|
70
|
+
expect(fs.readFileSync(path.join(dir, files[0]), 'utf8')).toBe('// edited\n');
|
|
71
|
+
expect(fs.existsSync(path.join(dir, files[1]))).toBe(false);
|
|
72
|
+
}, SLOW);
|
|
73
|
+
|
|
74
|
+
it('upgrade --install-deps names the failure without it, in help and in the API doc', async () => {
|
|
75
|
+
const help = await optionText('upgrade', '--install-deps');
|
|
76
|
+
const param = upgradeFn.params?.find(p => p.name === 'options.installDeps')?.description ?? '';
|
|
77
|
+
for (const text of [help, param]) {
|
|
78
|
+
expect(text).not.toMatch(/prompt/i);
|
|
79
|
+
expect(text).toContain('ERR_DEP_MISSING');
|
|
80
|
+
}
|
|
81
|
+
}, SLOW);
|
|
82
|
+
|
|
83
|
+
it('ERR_FILE_EXISTS is described without an interactive mode, in the code set, its doc and the README table', () => {
|
|
84
|
+
const member = errorCodesDoc.members.find(m => m.value === 'ERR_FILE_EXISTS');
|
|
85
|
+
expect(member?.description).toBe('Refused to overwrite an existing file.');
|
|
86
|
+
|
|
87
|
+
const source = fs.readFileSync(path.join(CLI_ROOT, 'foundation/response/error-codes.mjs'), 'utf8');
|
|
88
|
+
expect(source).toMatch(/\/\*\* Refused to overwrite an existing file\. \*\/\s*ERR_FILE_EXISTS:/);
|
|
89
|
+
|
|
90
|
+
const readme = fs.readFileSync(path.join(CLI_ROOT, 'README.md'), 'utf8');
|
|
91
|
+
const row = readme.split('\n').find(line => line.startsWith('| `ERR_FILE_EXISTS`'));
|
|
92
|
+
expect(row).toMatch(/\| Refused to overwrite an existing file\.\s+\|$/);
|
|
93
|
+
});
|
|
94
|
+
});
|
|
@@ -12,7 +12,7 @@ export const doc = {
|
|
|
12
12
|
type: 'command',
|
|
13
13
|
name: 'search',
|
|
14
14
|
displayName: 'astryx search',
|
|
15
|
-
namespace: 'cli',
|
|
15
|
+
namespace: 'cli/commands',
|
|
16
16
|
summary: 'Search components, hooks, docs, and templates in one ranked list',
|
|
17
17
|
description:
|
|
18
18
|
'Terminal front-end to search(): prints one ranked, greppable list across ' +
|
|
@@ -29,11 +29,11 @@ export const doc = {
|
|
|
29
29
|
{
|
|
30
30
|
flag: '--limit <n>',
|
|
31
31
|
param: 'options.limit',
|
|
32
|
-
description: 'Max number of results (default 20)',
|
|
32
|
+
description: 'Max number of results, a positive integer (default 20)',
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
flag: '--verbose',
|
|
36
|
-
description:
|
|
36
|
+
description: "Also print each result's score and match reason",
|
|
37
37
|
},
|
|
38
38
|
],
|
|
39
39
|
examples: [
|
|
@@ -45,7 +45,10 @@ export const doc = {
|
|
|
45
45
|
],
|
|
46
46
|
exitCodes: [
|
|
47
47
|
{code: 0, when: 'success (including zero matches)'},
|
|
48
|
-
{
|
|
48
|
+
{
|
|
49
|
+
code: 1,
|
|
50
|
+
when: 'invalid --type, a --limit that is not a positive integer, or @astryxdesign/core cannot be found',
|
|
51
|
+
},
|
|
49
52
|
],
|
|
50
53
|
related: ['component', 'hook', 'docs', 'template', 'build'],
|
|
51
54
|
};
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* astryx search button Ranked results across all domains
|
|
17
17
|
* astryx search modal --type component Filter to a single domain
|
|
18
18
|
* astryx search forms --limit 5 Cap the result count
|
|
19
|
-
* astryx search button --verbose
|
|
19
|
+
* astryx search button --verbose Also print score / reason
|
|
20
20
|
* astryx search button --json Typed JSON envelope
|
|
21
21
|
*/
|
|
22
22
|
|
|
@@ -49,16 +49,15 @@ export function registerSearch(program) {
|
|
|
49
49
|
|
|
50
50
|
try {
|
|
51
51
|
const project = await Project.load(process.cwd());
|
|
52
|
-
await warnOnIntegrationIssues(project
|
|
52
|
+
await warnOnIntegrationIssues(project, {json});
|
|
53
53
|
} catch {
|
|
54
54
|
// Never let the nudge break the command.
|
|
55
55
|
}
|
|
56
56
|
|
|
57
|
-
//
|
|
58
|
-
//
|
|
59
|
-
//
|
|
60
|
-
const limit =
|
|
61
|
-
options.limit != null ? Number.parseInt(options.limit, 10) : 20;
|
|
57
|
+
// Number(), not parseInt(): parseInt truncates `1.5` and `5abc` into
|
|
58
|
+
// integers the API would reject. The API validates the value, so the
|
|
59
|
+
// flag and `search({limit})` accept and refuse the same inputs.
|
|
60
|
+
const limit = options.limit != null ? Number(options.limit) : 20;
|
|
62
61
|
|
|
63
62
|
/** @type {import('../../../api/search/search.type.mjs').SearchResponse} */
|
|
64
63
|
let result;
|
|
@@ -116,15 +115,32 @@ export function registerSearch(program) {
|
|
|
116
115
|
const fields = options.verbose
|
|
117
116
|
? [
|
|
118
117
|
'name',
|
|
118
|
+
'section',
|
|
119
119
|
'domain',
|
|
120
|
+
'package',
|
|
121
|
+
'title',
|
|
120
122
|
'displayName',
|
|
123
|
+
'kind',
|
|
121
124
|
'score',
|
|
122
125
|
'reason',
|
|
123
126
|
'import',
|
|
124
127
|
'description',
|
|
125
128
|
'command',
|
|
129
|
+
'parent',
|
|
126
130
|
]
|
|
127
|
-
: [
|
|
131
|
+
: [
|
|
132
|
+
'name',
|
|
133
|
+
'section',
|
|
134
|
+
'domain',
|
|
135
|
+
'package',
|
|
136
|
+
'title',
|
|
137
|
+
'displayName',
|
|
138
|
+
'kind',
|
|
139
|
+
'import',
|
|
140
|
+
'description',
|
|
141
|
+
'command',
|
|
142
|
+
'parent',
|
|
143
|
+
];
|
|
128
144
|
|
|
129
145
|
// The heading mirrors the JSON: `matchCount` is what matched, and the
|
|
130
146
|
// records below are the slice `--limit` allowed. Saying only "(20)" when
|
|
@@ -135,7 +151,10 @@ export function registerSearch(program) {
|
|
|
135
151
|
? `Results for "${q}" (${results.length} of ${matchCount})`
|
|
136
152
|
: `Results for "${q}" (${results.length})`,
|
|
137
153
|
),
|
|
138
|
-
records(results, {
|
|
154
|
+
records(results, {
|
|
155
|
+
fields,
|
|
156
|
+
format: {command: formatCliCommand, parent: formatCliCommand},
|
|
157
|
+
}),
|
|
139
158
|
);
|
|
140
159
|
return answered;
|
|
141
160
|
},
|
|
@@ -11,6 +11,8 @@
|
|
|
11
11
|
*/
|
|
12
12
|
|
|
13
13
|
import {describe, it, expect} from 'vitest';
|
|
14
|
+
import * as fs from 'node:fs';
|
|
15
|
+
import * as os from 'node:os';
|
|
14
16
|
import * as path from 'node:path';
|
|
15
17
|
import {fileURLToPath} from 'node:url';
|
|
16
18
|
import {search, scoreCandidate, SEARCH_DOMAINS} from '../../../api/search/search.mjs';
|
|
@@ -28,6 +30,33 @@ const OPTS = {cwd: REPO_ROOT};
|
|
|
28
30
|
// the vitest per-test timeout. Give both the same generous scan budget.
|
|
29
31
|
const SCAN_TIMEOUT = 30_000;
|
|
30
32
|
|
|
33
|
+
/**
|
|
34
|
+
* A JSON value as the formatters print it (they normalize typography to ASCII).
|
|
35
|
+
* @param {unknown} value
|
|
36
|
+
*/
|
|
37
|
+
function asText(value) {
|
|
38
|
+
return (Array.isArray(value) ? value.join(', ') : String(value))
|
|
39
|
+
.replace(/[\u2014\u2013]/g, '-')
|
|
40
|
+
.replace(/[\u2018\u2019]/g, "'")
|
|
41
|
+
.replace(/[\u201C\u201D]/g, '"')
|
|
42
|
+
.replace(/\u2026/g, '...')
|
|
43
|
+
.replace(/\u00a0/g, ' ')
|
|
44
|
+
.trimEnd();
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Whether some text line prints `key:` with this value. The command field gains
|
|
49
|
+
* the caller's invocation prefix, so the value is matched as the line's end; a
|
|
50
|
+
* multi-line value is matched by its first line.
|
|
51
|
+
* @param {string[]} lines
|
|
52
|
+
* @param {string} key
|
|
53
|
+
* @param {unknown} value
|
|
54
|
+
*/
|
|
55
|
+
function printsField(lines, key, value) {
|
|
56
|
+
const shown = asText(value).split('\n')[0].trimEnd();
|
|
57
|
+
return lines.some(line => line.startsWith(`${key}:`) && line.trimEnd().endsWith(shown));
|
|
58
|
+
}
|
|
59
|
+
|
|
31
60
|
describe('search() API — ranking', () => {
|
|
32
61
|
it('ranks an exact component name match first', async () => {
|
|
33
62
|
const {data} = await search('button', OPTS);
|
|
@@ -172,6 +201,20 @@ describe('search CLI — exit codes + JSON contract', () => {
|
|
|
172
201
|
expect(r.status).toBe(1);
|
|
173
202
|
});
|
|
174
203
|
|
|
204
|
+
it.each(['1.5', '5abc'])(
|
|
205
|
+
'refuses --limit %s like search({limit}) does, in both modes',
|
|
206
|
+
async value => {
|
|
207
|
+
await expect(
|
|
208
|
+
search('x', {...OPTS, limit: Number(value)}),
|
|
209
|
+
).rejects.toMatchObject({code: 'ERR_INVALID_ARGUMENT'});
|
|
210
|
+
const json = await runCli(['--json', 'search', 'x', '--limit', value], REPO_ROOT);
|
|
211
|
+
expect(json.status).toBe(1);
|
|
212
|
+
expect(JSON.parse(json.stdout)).toMatchObject({code: 'ERR_INVALID_ARGUMENT'});
|
|
213
|
+
const text = await runCli(['search', 'x', '--limit', value], REPO_ROOT);
|
|
214
|
+
expect(text.status).toBe(1);
|
|
215
|
+
},
|
|
216
|
+
);
|
|
217
|
+
|
|
175
218
|
it('emits a valid --json envelope', async () => {
|
|
176
219
|
const r = await runCli(['--json', 'search', 'button'], REPO_ROOT);
|
|
177
220
|
expect(r.status).toBe(0);
|
|
@@ -223,6 +266,25 @@ describe('search CLI — exit codes + JSON contract', () => {
|
|
|
223
266
|
expect(r.stdout).toContain('description:');
|
|
224
267
|
});
|
|
225
268
|
|
|
269
|
+
it('prints every result field under its JSON key (score and reason with --verbose)', async () => {
|
|
270
|
+
// One query that reaches all four domains, so every per-domain field shows.
|
|
271
|
+
const args = ['search', 'theme', '--limit', '60'];
|
|
272
|
+
const env = JSON.parse((await runCli(['--json', ...args], REPO_ROOT)).stdout);
|
|
273
|
+
expect(new Set(env.data.results.map(r => r.domain))).toEqual(new Set(SEARCH_DOMAINS));
|
|
274
|
+
const plain = (await runCli(args, REPO_ROOT)).stdout.split('\n');
|
|
275
|
+
const verbose = (await runCli([...args, '--verbose'], REPO_ROOT)).stdout.split('\n');
|
|
276
|
+
for (const result of env.data.results) {
|
|
277
|
+
for (const [key, value] of Object.entries(result)) {
|
|
278
|
+
if (value == null || value === '') continue;
|
|
279
|
+
const label = `${result.domain} ${result.name}: ${key}`;
|
|
280
|
+
expect(printsField(verbose, key, value), label).toBe(true);
|
|
281
|
+
if (key !== 'score' && key !== 'reason') {
|
|
282
|
+
expect(printsField(plain, key, value), label).toBe(true);
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
}, 90_000);
|
|
287
|
+
|
|
226
288
|
it('--verbose exits 0 and prints import/match detail', async () => {
|
|
227
289
|
// Regression: the boolean verbose flag was named --detail, which collided
|
|
228
290
|
// with the value-taking global `--detail <level>` — a bare `search
|
|
@@ -236,4 +298,17 @@ describe('search CLI — exit codes + JSON contract', () => {
|
|
|
236
298
|
expect(r.stdout).toContain('score:');
|
|
237
299
|
expect(r.stdout).toContain('reason:');
|
|
238
300
|
});
|
|
301
|
+
|
|
302
|
+
it('exits 1 with ERR_CORE_NOT_FOUND when no @astryxdesign/core is reachable', async () => {
|
|
303
|
+
const empty = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-search-cli-no-core-'));
|
|
304
|
+
try {
|
|
305
|
+
const json = await runCli(['--json', 'search', 'button'], empty);
|
|
306
|
+
expect(json.status).toBe(1);
|
|
307
|
+
expect(JSON.parse(json.stdout)).toMatchObject({code: 'ERR_CORE_NOT_FOUND'});
|
|
308
|
+
const text = await runCli(['search', 'button'], empty);
|
|
309
|
+
expect(text.status).toBe(1);
|
|
310
|
+
} finally {
|
|
311
|
+
fs.rmSync(empty, {recursive: true, force: true});
|
|
312
|
+
}
|
|
313
|
+
});
|
|
239
314
|
}, SCAN_TIMEOUT);
|
|
@@ -89,6 +89,12 @@ describe('enforcement layer 3 — per-command setup nudge', () => {
|
|
|
89
89
|
expect((await runCli(['docs', 'tokens'], tmp)).stderr).not.toMatch(NUDGE);
|
|
90
90
|
});
|
|
91
91
|
|
|
92
|
+
it('is quiet in an integration package, which is not an app', async () => {
|
|
93
|
+
asProject();
|
|
94
|
+
write('astryx.integration.mjs', 'export default {};\n');
|
|
95
|
+
expect((await runCli(['docs', 'tokens'], tmp)).stderr).not.toMatch(NUDGE);
|
|
96
|
+
});
|
|
97
|
+
|
|
92
98
|
it('does not nudge for the installer command itself', async () => {
|
|
93
99
|
asProject();
|
|
94
100
|
expect((await runCli(['init'], tmp)).stderr).not.toMatch(NUDGE);
|
|
@@ -12,7 +12,7 @@ export const doc = {
|
|
|
12
12
|
type: 'command',
|
|
13
13
|
name: 'swizzle',
|
|
14
14
|
displayName: 'astryx swizzle',
|
|
15
|
-
namespace: 'cli',
|
|
15
|
+
namespace: 'cli/commands',
|
|
16
16
|
summary: 'Copy component source for customization',
|
|
17
17
|
description:
|
|
18
18
|
"Ejects a component's source from the resolved @astryxdesign/core (or its owning " +
|
|
@@ -40,7 +40,8 @@ export const doc = {
|
|
|
40
40
|
{
|
|
41
41
|
flag: '-f, --overwrite',
|
|
42
42
|
param: 'options.overwrite',
|
|
43
|
-
description:
|
|
43
|
+
description:
|
|
44
|
+
'Replace existing files. Without it, existing files fail the command with ERR_FILE_EXISTS and nothing is written',
|
|
44
45
|
},
|
|
45
46
|
],
|
|
46
47
|
examples: [
|
|
@@ -74,6 +74,37 @@ describe('swizzle path safety', () => {
|
|
|
74
74
|
expect(fs.existsSync(absTarget)).toBe(false);
|
|
75
75
|
});
|
|
76
76
|
|
|
77
|
+
it('rejects a component directory that is a symlink out of the project', async () => {
|
|
78
|
+
const {project, outside} = buildFakeRepo(tmpDir);
|
|
79
|
+
const base = path.join(project, 'components', 'astryx');
|
|
80
|
+
fs.mkdirSync(base, {recursive: true});
|
|
81
|
+
fs.symlinkSync(outside, path.join(base, 'Button'));
|
|
82
|
+
|
|
83
|
+
const result = await runCli(['--json', 'swizzle', 'Button'], project);
|
|
84
|
+
|
|
85
|
+
expect(result.code).not.toBe(0);
|
|
86
|
+
expect(JSON.parse(result.stdout).code).toBe('ERR_PATH_TRAVERSAL');
|
|
87
|
+
expect(fs.readdirSync(outside)).toEqual([]);
|
|
88
|
+
});
|
|
89
|
+
|
|
90
|
+
it('rejects an existing file that is a symlink out of the project, even with --overwrite', async () => {
|
|
91
|
+
const {project, outside} = buildFakeRepo(tmpDir);
|
|
92
|
+
const outDir = path.join(project, 'components', 'astryx', 'Button');
|
|
93
|
+
fs.mkdirSync(outDir, {recursive: true});
|
|
94
|
+
const target = path.join(outside, 'kept.txt');
|
|
95
|
+
fs.writeFileSync(target, 'kept\n');
|
|
96
|
+
fs.symlinkSync(target, path.join(outDir, 'Button.tsx'));
|
|
97
|
+
|
|
98
|
+
const result = await runCli(
|
|
99
|
+
['--json', 'swizzle', 'Button', '--overwrite'],
|
|
100
|
+
project,
|
|
101
|
+
);
|
|
102
|
+
|
|
103
|
+
expect(result.code).not.toBe(0);
|
|
104
|
+
expect(JSON.parse(result.stdout).code).toBe('ERR_PATH_TRAVERSAL');
|
|
105
|
+
expect(fs.readFileSync(target, 'utf-8')).toBe('kept\n');
|
|
106
|
+
});
|
|
107
|
+
|
|
77
108
|
it('requires --overwrite in non-interactive mode when files already exist', async () => {
|
|
78
109
|
const {project} = buildFakeRepo(tmpDir);
|
|
79
110
|
const outDir = path.join(project, 'components', 'astryx', 'Button');
|
|
@@ -92,4 +123,15 @@ describe('swizzle path safety', () => {
|
|
|
92
123
|
// Existing file unchanged
|
|
93
124
|
expect(fs.readFileSync(existingPath, 'utf-8')).toBe('// my customizations\n');
|
|
94
125
|
});
|
|
126
|
+
|
|
127
|
+
// The CLI never prompts: without --overwrite it refuses with a code, and the
|
|
128
|
+
// manifest agents read must say so.
|
|
129
|
+
it('describes --overwrite by its refusal, not a prompt', async () => {
|
|
130
|
+
const {project} = buildFakeRepo(tmpDir);
|
|
131
|
+
const result = await runCli(['--json', 'manifest'], project);
|
|
132
|
+
const swizzle = JSON.parse(result.stdout).data.commands.find(c => c.name === 'swizzle');
|
|
133
|
+
const overwrite = swizzle.options.find(o => o.flag.includes('--overwrite'));
|
|
134
|
+
expect(overwrite.description).not.toMatch(/prompt/i);
|
|
135
|
+
expect(overwrite.description).toContain('ERR_FILE_EXISTS');
|
|
136
|
+
});
|
|
95
137
|
});
|
|
@@ -13,21 +13,41 @@ export const doc = {
|
|
|
13
13
|
type: 'command',
|
|
14
14
|
name: 'template',
|
|
15
15
|
displayName: 'astryx template',
|
|
16
|
-
namespace: 'cli',
|
|
16
|
+
namespace: 'cli/commands',
|
|
17
17
|
summary: 'Inject a page or block template',
|
|
18
18
|
description:
|
|
19
19
|
'One entry point for the template family: with no name it lists the discovered ' +
|
|
20
20
|
'templates; with a name it shows the source or a layout skeleton, or scaffolds it ' +
|
|
21
|
-
'into the project at a target path.
|
|
22
|
-
'
|
|
23
|
-
'
|
|
21
|
+
'into the project at a target path. A configured integration replacement is the ' +
|
|
22
|
+
'default for its Core id; use --package @astryxdesign/core for the original. ' +
|
|
23
|
+
'Narrow other ambiguous names with --type and/or --package. --cdn writes the ' +
|
|
24
|
+
'no-build-step CDN starter page, which ships as an asset rather than as a ' +
|
|
25
|
+
'discovered template.',
|
|
24
26
|
fn: 'template',
|
|
25
27
|
args: [
|
|
26
|
-
{
|
|
27
|
-
|
|
28
|
+
{
|
|
29
|
+
name: 'name',
|
|
30
|
+
param: 'name',
|
|
31
|
+
required: false,
|
|
32
|
+
description: 'Template id (see --list). Omit it to list the templates.',
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
name: 'path',
|
|
36
|
+
param: 'options.targetPath',
|
|
37
|
+
required: false,
|
|
38
|
+
description:
|
|
39
|
+
'Where to scaffold the template, relative to the project root. A path that ends in .tsx, .ts, .jsx, .js, .mjs, .cjs, .css, .scss, .json, .md or .html is the file to write; ' +
|
|
40
|
+
"any other path is a directory, which receives page.tsx for a page template or the block's own file name for a block. " +
|
|
41
|
+
'Omit it to print the source.',
|
|
42
|
+
},
|
|
28
43
|
],
|
|
29
44
|
options: [
|
|
30
|
-
{
|
|
45
|
+
{
|
|
46
|
+
flag: '--list',
|
|
47
|
+
param: 'options.list',
|
|
48
|
+
description:
|
|
49
|
+
'List available templates (narrow with --type and --package) and do nothing else: <name>, <path>, --skeleton and --overwrite are ignored',
|
|
50
|
+
},
|
|
31
51
|
{
|
|
32
52
|
flag: '--type <type>',
|
|
33
53
|
param: 'options.type',
|
|
@@ -37,37 +57,56 @@ export const doc = {
|
|
|
37
57
|
{
|
|
38
58
|
flag: '--package <pkg>',
|
|
39
59
|
param: 'options.package',
|
|
40
|
-
description:
|
|
60
|
+
description:
|
|
61
|
+
'Narrow to templates from a specific package. Use @astryxdesign/core to select an original hidden by an integration replacement.',
|
|
41
62
|
},
|
|
42
63
|
{
|
|
43
64
|
flag: '--skeleton',
|
|
44
65
|
param: 'options.skeleton',
|
|
45
66
|
description:
|
|
46
|
-
'Show layout skeleton with spatial annotations (padding, gap, nesting)'
|
|
67
|
+
'Show layout skeleton with spatial annotations (padding, gap, nesting) instead of the source. Needs <name>. ' +
|
|
68
|
+
'It writes nothing, so <path> and --overwrite are ignored; --list and --cdn take precedence',
|
|
47
69
|
},
|
|
48
70
|
{
|
|
49
71
|
flag: '--cdn [path]',
|
|
50
72
|
param: 'options.cdn',
|
|
51
73
|
description:
|
|
52
|
-
'Write the no-build-step CDN starter page
|
|
74
|
+
'Write the no-build-step CDN starter page and do nothing else: <name>, --list, --skeleton, --type and --package are ignored. ' +
|
|
75
|
+
'The page goes to the --cdn value, else to <path>, else cdn.template.html, and that path is always the file itself. ' +
|
|
76
|
+
'A value right after --cdn (anything not starting with -) is taken as that path',
|
|
53
77
|
},
|
|
54
78
|
{
|
|
55
79
|
flag: '-f, --overwrite',
|
|
56
80
|
param: 'options.overwrite',
|
|
57
|
-
description:
|
|
81
|
+
description:
|
|
82
|
+
'Replace an existing target file. Without it an existing file is refused (ERR_FILE_EXISTS) and an existing CDN page is left as is',
|
|
58
83
|
},
|
|
59
84
|
],
|
|
60
85
|
examples: [
|
|
61
86
|
{label: 'List templates', cli: 'astryx template --json'},
|
|
87
|
+
{
|
|
88
|
+
label: 'List exact Core ids',
|
|
89
|
+
cli: 'astryx --json template --list --package @astryxdesign/core',
|
|
90
|
+
},
|
|
62
91
|
{
|
|
63
92
|
label: 'Scaffold into the app',
|
|
64
93
|
cli: 'astryx template dashboard ./src/app',
|
|
65
94
|
},
|
|
95
|
+
{
|
|
96
|
+
label: 'Select a replaced Core original',
|
|
97
|
+
cli: 'astryx template shell-side-nav ./src/app --package @astryxdesign/core',
|
|
98
|
+
},
|
|
66
99
|
{label: 'CDN starter page', cli: 'astryx template --cdn'},
|
|
67
|
-
{
|
|
100
|
+
{
|
|
101
|
+
label: 'CDN starter page, elsewhere',
|
|
102
|
+
cli: 'astryx template --cdn public/demo.html',
|
|
103
|
+
},
|
|
68
104
|
],
|
|
69
105
|
exitCodes: [
|
|
70
|
-
{
|
|
106
|
+
{
|
|
107
|
+
code: 0,
|
|
108
|
+
when: 'success, including a CDN page left untouched because it already exists',
|
|
109
|
+
},
|
|
71
110
|
{
|
|
72
111
|
code: 1,
|
|
73
112
|
when: 'unknown or ambiguous template, no source, a path escape, or an existing target without --overwrite',
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
// Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @file `astryx template` documents which of its flags win when they are
|
|
5
|
+
* combined, and behaves as documented. Option text is read from the generated
|
|
6
|
+
* manifest, the same strings `--help` prints.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import {describe, it, expect, beforeEach, afterEach} from 'vitest';
|
|
10
|
+
import * as fs from 'node:fs';
|
|
11
|
+
import * as os from 'node:os';
|
|
12
|
+
import * as path from 'node:path';
|
|
13
|
+
import {runCli} from '../../../test-utils/run-cli.mjs';
|
|
14
|
+
|
|
15
|
+
const SLOW = 30_000;
|
|
16
|
+
|
|
17
|
+
/** @type {string} */
|
|
18
|
+
let tmpDir;
|
|
19
|
+
|
|
20
|
+
beforeEach(() => {
|
|
21
|
+
tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-template-flags-'));
|
|
22
|
+
fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({name: 'consumer'}));
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
afterEach(() => {
|
|
26
|
+
fs.rmSync(tmpDir, {recursive: true, force: true});
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
/** @param {string} rel */
|
|
30
|
+
const exists = rel => fs.existsSync(path.join(tmpDir, rel));
|
|
31
|
+
|
|
32
|
+
/** Files in the project, ignoring package.json. */
|
|
33
|
+
const written = () => fs.readdirSync(tmpDir).filter(f => f !== 'package.json');
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* template's option descriptions from the manifest, keyed by long flag.
|
|
37
|
+
* @returns {Promise<Record<string, string>>}
|
|
38
|
+
*/
|
|
39
|
+
async function templateOptions() {
|
|
40
|
+
const {stdout} = await runCli(['--json', 'manifest'], tmpDir);
|
|
41
|
+
const template = JSON.parse(stdout).data.commands.find(
|
|
42
|
+
(/** @type {{name: string}} */ c) => c.name === 'template',
|
|
43
|
+
);
|
|
44
|
+
return Object.fromEntries(
|
|
45
|
+
template.options.map((/** @type {{flag: string, description: string}} */ o) => [
|
|
46
|
+
o.flag.match(/--[a-z-]+/)?.[0],
|
|
47
|
+
o.description,
|
|
48
|
+
]),
|
|
49
|
+
);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** @param {string[]} args */
|
|
53
|
+
async function templateJson(args) {
|
|
54
|
+
const result = await runCli(['--json', 'template', ...args], tmpDir);
|
|
55
|
+
return {status: result.status, envelope: JSON.parse(result.stdout)};
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
describe('astryx template flag precedence', () => {
|
|
59
|
+
it('--list: help says <name>, <path>, --skeleton and --overwrite are ignored, and they are', async () => {
|
|
60
|
+
const help = (await templateOptions())['--list'];
|
|
61
|
+
for (const ignored of ['<name>', '<path>', '--skeleton', '--overwrite']) {
|
|
62
|
+
expect(help).toContain(ignored);
|
|
63
|
+
}
|
|
64
|
+
expect(help).toMatch(/are ignored/);
|
|
65
|
+
|
|
66
|
+
const {status, envelope} = await templateJson([
|
|
67
|
+
'dashboard',
|
|
68
|
+
'./src/page.tsx',
|
|
69
|
+
'--list',
|
|
70
|
+
'--skeleton',
|
|
71
|
+
'--overwrite',
|
|
72
|
+
]);
|
|
73
|
+
expect(status).toBe(0);
|
|
74
|
+
expect(envelope.type).toBe('template.list');
|
|
75
|
+
expect(written()).toEqual([]);
|
|
76
|
+
}, SLOW);
|
|
77
|
+
|
|
78
|
+
it('--skeleton: help says it needs <name> and writes nothing, and it does', async () => {
|
|
79
|
+
const help = (await templateOptions())['--skeleton'];
|
|
80
|
+
expect(help).toMatch(/Needs <name>/);
|
|
81
|
+
expect(help).toMatch(/writes nothing, so <path> and --overwrite are ignored/);
|
|
82
|
+
expect(help).toMatch(/--list and --cdn take precedence/);
|
|
83
|
+
|
|
84
|
+
const shown = await templateJson(['dashboard', './src/page.tsx', '--skeleton', '--overwrite']);
|
|
85
|
+
expect(shown.status).toBe(0);
|
|
86
|
+
expect(shown.envelope.type).toBe('template.skeleton');
|
|
87
|
+
expect(written()).toEqual([]);
|
|
88
|
+
|
|
89
|
+
const nameless = await templateJson(['--skeleton']);
|
|
90
|
+
expect(nameless.status).toBe(1);
|
|
91
|
+
expect(nameless.envelope.code).toBe('ERR_UNKNOWN_TEMPLATE');
|
|
92
|
+
}, SLOW);
|
|
93
|
+
|
|
94
|
+
it('--cdn: help says it overrides everything and where the page goes, and the CLI does that', async () => {
|
|
95
|
+
const help = (await templateOptions())['--cdn'];
|
|
96
|
+
for (const ignored of ['<name>', '--list', '--skeleton', '--type', '--package']) {
|
|
97
|
+
expect(help).toContain(ignored);
|
|
98
|
+
}
|
|
99
|
+
expect(help).toMatch(/--cdn value, else to <path>, else cdn\.template\.html/);
|
|
100
|
+
expect(help).toMatch(/always the file itself/);
|
|
101
|
+
expect(help).toMatch(/value right after --cdn/);
|
|
102
|
+
|
|
103
|
+
const everything = await templateJson(['dashboard', '--list', '--skeleton', '--type', 'bogus', '--cdn']);
|
|
104
|
+
expect(everything.envelope.type).toBe('template.cdn');
|
|
105
|
+
expect(everything.envelope.data.path).toBe('cdn.template.html');
|
|
106
|
+
|
|
107
|
+
// A bare --cdn writes to <path>, and a path with no extension is still the file.
|
|
108
|
+
const positional = await templateJson(['dashboard', 'demo', '--cdn']);
|
|
109
|
+
expect(positional.envelope.data.path).toBe('demo');
|
|
110
|
+
expect(fs.statSync(path.join(tmpDir, 'demo')).isFile()).toBe(true);
|
|
111
|
+
|
|
112
|
+
// The word after --cdn is its value, not the template name.
|
|
113
|
+
const value = await templateJson(['--cdn', 'dashboard']);
|
|
114
|
+
expect(value.envelope.data.path).toBe('dashboard');
|
|
115
|
+
expect(exists('dashboard')).toBe(true);
|
|
116
|
+
}, SLOW);
|
|
117
|
+
});
|