@astryxdesign/cli 0.6.3-canary.3e8c2f1 → 0.6.3-canary.3ee796c

package/api/build/build.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json build (no query) — the "how to build a page" playbook signal.
+ * xds --json build (no query) — the "how to build a page" playbook signal.
  */
 export type BuildHelpResponse = {
     type: "build.help";
@@ -11,7 +11,7 @@ export type BuildHelpResponse = {
     };
 };
 /**
- * astryx --json build "<idea>" — the composition kit for what you're building.
+ * xds --json build "<idea>" — the composition kit for what you're building.
  *
  * Entries are raw `SearchResultEntry` objects (no package-manager-prefixed
  * command strings — the CLI adds those); `frame`/`foundation` are static

package/api/build/build.type.mjs

@@ -7,7 +7,7 @@
  */
 
 /**
- * astryx --json build (no query) — the "how to build a page" playbook signal.
+ * xds --json build (no query) — the "how to build a page" playbook signal.
  *
  * @typedef {object} BuildHelpResponse
  * @property {'build.help'} type
@@ -16,7 +16,7 @@
  */
 
 /**
- * astryx --json build "<idea>" — the composition kit for what you're building.
+ * xds --json build "<idea>" — the composition kit for what you're building.
  *
  * Entries are raw `SearchResultEntry` objects (no package-manager-prefixed
  * command strings — the CLI adds those); `frame`/`foundation` are static

package/api/component/component.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json component [--list] [--category X] [--detail names|compact|full]
+ * xds --json component [--list] [--category X] [--detail names|compact|full]
  *
  * The list view emits ONE `component.list` type across all three detail levels;
  * the depth is carried in `data.detail` and `data.components` holds the grouped
@@ -55,7 +55,7 @@ export type ComponentBriefEntry = {
     import: string;
 };
 /**
- * astryx --json component <name>
+ * xds --json component <name>
  */
 export type ComponentDetailResponse = {
     type: "component.detail";
@@ -81,14 +81,14 @@ export type ComponentOwnership = {
     sourceAvailable: boolean;
 };
 /**
- * astryx --json component <name> --props
+ * xds --json component <name> --props
  */
 export type ComponentDetailPropsResponse = {
     type: "component.detail.props";
     data: import("@astryxdesign/cli/authoring").ComponentPropDoc[];
 };
 /**
- * astryx --json component <name> --source
+ * xds --json component <name> --source
  */
 export type ComponentDetailSourceResponse = {
     type: "component.detail.source";
@@ -98,7 +98,7 @@ export type ComponentDetailSourceResponse = {
     };
 };
 /**
- * astryx --json component <name> --showcase
+ * xds --json component <name> --showcase
  */
 export type ComponentDetailShowcaseResponse = {
     type: "component.detail.showcase";
@@ -109,7 +109,7 @@ export type ComponentDetailShowcaseResponse = {
     };
 };
 /**
- * astryx --json component <name> --blocks
+ * xds --json component <name> --blocks
  */
 export type ComponentDetailBlocksResponse = {
     type: "component.detail.blocks";

package/api/component/component.type.mjs

@@ -3,7 +3,7 @@
 /**
  * @file Colocated types for the `component` command — source of truth for the
  * component command's JSON responses. These typedefs describe the `{type, data}`
- * envelopes emitted by `astryx --json component` and returned by the `component()`
+ * envelopes emitted by `xds --json component` and returned by the `component()`
  * API; the `types/component.d.ts` barrel re-exports them for consumers.
  *
  * Detail-level contract for list views (brief < compact < full):
@@ -11,23 +11,23 @@
  *   --detail compact  Names + 1-line description + import path.
  *   --detail full     Full ComponentDoc per entry (props, theming, examples, etc.).
  *
- * Invocation                                      -> type discriminator
+ * Invocation                                 -> type discriminator
  * ------------------------------------------------------------------
- * astryx --json component                         -> component.list (data.detail='names')
- * astryx --json component --list                  -> component.list (data.detail='names')
- * astryx --json component --category Form         -> component.list (filtered)
- * astryx --json component --list --detail compact -> component.list (data.detail='compact')
- * astryx --json component --list --detail full    -> component.list (data.detail='full')
- * astryx --json component Button                  -> component.detail
- * astryx --json component Button --props          -> component.detail.props
- * astryx --json component Button --source         -> component.detail.source
- * astryx --json component Button --showcase       -> component.detail.showcase
- * astryx --json component Button --blocks         -> component.detail.blocks
- * (not found)                                     -> CLIError
+ * xds --json component                      -> component.list (data.detail='names')
+ * xds --json component --list               -> component.list (data.detail='names')
+ * xds --json component --category Form      -> component.list (filtered)
+ * xds --json component --list --detail compact -> component.list (data.detail='compact')
+ * xds --json component --list --detail full -> component.list (data.detail='full')
+ * xds --json component Button               -> component.detail
+ * xds --json component Button --props       -> component.detail.props
+ * xds --json component Button --source      -> component.detail.source
+ * xds --json component Button --showcase    -> component.detail.showcase
+ * xds --json component Button --blocks      -> component.detail.blocks
+ * (not found)                               -> CLIError
  */
 
 /**
- * astryx --json component [--list] [--category X] [--detail names|compact|full]
+ * xds --json component [--list] [--category X] [--detail names|compact|full]
  *
  * The list view emits ONE `component.list` type across all three detail levels;
  * the depth is carried in `data.detail` and `data.components` holds the grouped
@@ -70,7 +70,7 @@
  */
 
 /**
- * astryx --json component <name>
+ * xds --json component <name>
  * @typedef {object} ComponentDetailResponse
  * @property {'component.detail'} type
  * @property {import('@astryxdesign/cli/authoring').ComponentDoc & ComponentOwnership} data
@@ -87,28 +87,28 @@
  */
 
 /**
- * astryx --json component <name> --props
+ * xds --json component <name> --props
  * @typedef {object} ComponentDetailPropsResponse
  * @property {'component.detail.props'} type
  * @property {import('@astryxdesign/cli/authoring').ComponentPropDoc[]} data
  */
 
 /**
- * astryx --json component <name> --source
+ * xds --json component <name> --source
  * @typedef {object} ComponentDetailSourceResponse
  * @property {'component.detail.source'} type
  * @property {{component: string; source: string}} data
  */
 
 /**
- * astryx --json component <name> --showcase
+ * xds --json component <name> --showcase
  * @typedef {object} ComponentDetailShowcaseResponse
  * @property {'component.detail.showcase'} type
  * @property {{component: string; aspectRatio: number; source: string}} data
  */
 
 /**
- * astryx --json component <name> --blocks
+ * xds --json component <name> --blocks
  * @typedef {object} ComponentDetailBlocksResponse
  * @property {'component.detail.blocks'} type
  * @property {{component: string; showcase: BlockEntry | null; examples: BlockEntry[]; related: BlockEntry[]}} data

package/api/discover/discover.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json discover
+ * xds --json discover
  */
 export type DiscoverListResponse = {
     type: "discover.list";
@@ -25,21 +25,21 @@ export type DiscoverListEntry = {
     displayName?: string | undefined;
 };
 /**
- * astryx --json discover
+ * xds --json discover
  */
 export type DiscoverDetailResponse = {
     type: "discover.detail";
     data: DiscoverListEntry;
 };
 /**
- * astryx --json discover
+ * xds --json discover
  */
 export type DiscoverDetailDocResponse = {
     type: "discover.detail.doc";
     data: import("@astryxdesign/cli/authoring").ComponentDoc;
 };
 /**
- * astryx --json discover <searchterm> (multiple matches)
+ * xds --json discover <searchterm> (multiple matches)
  */
 export type DiscoverSearchResponse = {
     type: "discover.search";

package/api/discover/discover.type.mjs

@@ -6,16 +6,16 @@
  *
  * Invocation                                      -> type discriminator
  * ------------------------------------------------------------------
- * astryx --json discover                          -> discover.list
- * astryx --json discover @scope/name              -> discover.detail
- * astryx --json discover @scope/name/Component    -> discover.detail.doc
- * astryx --json discover <searchterm> (1 match)   -> discover.detail.doc
- * astryx --json discover <searchterm> (N matches) -> discover.search
- * (not found)                                     -> CLIError
+ * xds --json discover                            -> discover.list
+ * xds --json discover @scope/name                -> discover.detail
+ * xds --json discover @scope/name/Component      -> discover.detail.doc
+ * xds --json discover <searchterm> (1 match)     -> discover.detail.doc
+ * xds --json discover <searchterm> (N matches)   -> discover.search
+ * (not found)                                    -> CLIError
  */
 
 /**
- * astryx --json discover
+ * xds --json discover
  * @typedef {object} DiscoverListResponse
  * @property {'discover.list'} type
  * @property {DiscoverListEntry[]} data
@@ -35,21 +35,21 @@
  */
 
 /**
- * astryx --json discover @scope/name
+ * xds --json discover @scope/name
  * @typedef {object} DiscoverDetailResponse
  * @property {'discover.detail'} type
  * @property {DiscoverListEntry} data
  */
 
 /**
- * astryx --json discover @scope/name/Component
+ * xds --json discover @scope/name/Component
  * @typedef {object} DiscoverDetailDocResponse
  * @property {'discover.detail.doc'} type
  * @property {import('@astryxdesign/cli/authoring').ComponentDoc} data
  */
 
 /**
- * astryx --json discover <searchterm> (multiple matches)
+ * xds --json discover <searchterm> (multiple matches)
  * @typedef {object} DiscoverSearchResponse
  * @property {'discover.search'} type
  * @property {{query: string, matches: DiscoverSearchEntry[]}} data

package/api/docs/docs.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json docs
+ * xds --json docs
  */
 export type DocsListResponse = {
     type: "docs.list";
@@ -23,14 +23,14 @@ export type DocsListEntry = {
     replaces?: string | undefined;
 };
 /**
- * astryx --json docs <topic> --index
+ * xds --json docs <topic> --index
  */
 export type DocsIndexResponse = {
     type: "docs.index";
     data: DocsIndex;
 };
 /**
- * astryx --json docs <topic>
+ * xds --json docs <topic>
  */
 export type DocsDetailResponse = {
     type: "docs.detail";
@@ -62,7 +62,7 @@ export type DocsIndexSection = {
     summary: string;
 };
 /**
- * astryx --json docs <topic> <section>
+ * xds --json docs <topic> <section>
  */
 export type DocsDetailSectionResponse = {
     type: "docs.detail.section";

package/api/docs/docs.type.mjs

@@ -4,17 +4,17 @@
  * @file Colocated types for the `docs` command — source of truth for the docs
  *   command JSON responses. `types/docs.d.ts` re-exports these.
  *
- *   Invocation                           -> type discriminator
+ *   Invocation                          -> type discriminator
  *   ------------------------------------------------------------
- *   astryx --json docs                   -> docs.list
- *   astryx --json docs <topic>           -> docs.detail
- *   astryx --json docs <topic> --index   -> docs.index
- *   astryx --json docs <topic> <section> -> docs.detail.section
- *   (unknown topic/section)              -> CLIError
+ *   xds --json docs                     -> docs.list
+ *   xds --json docs <topic>             -> docs.detail
+ *   xds --json docs <topic> --index     -> docs.index
+ *   xds --json docs <topic> <section>   -> docs.detail.section
+ *   (unknown topic/section)             -> CLIError
  */
 
 /**
- * astryx --json docs
+ * xds --json docs
  * @typedef {object} DocsListResponse
  * @property {'docs.list'} type
  * @property {DocsListEntry[]} data
@@ -31,14 +31,14 @@
  */
 
 /**
- * astryx --json docs <topic> --index
+ * xds --json docs <topic> --index
  * @typedef {object} DocsIndexResponse
  * @property {'docs.index'} type
  * @property {DocsIndex} data
  */
 
 /**
- * astryx --json docs <topic>
+ * xds --json docs <topic>
  * @typedef {object} DocsDetailResponse
  * @property {'docs.detail'} type
  * @property {import('@astryxdesign/cli/authoring').ReferenceDoc} data
@@ -63,7 +63,7 @@
  */
 
 /**
- * astryx --json docs <topic> <section>
+ * xds --json docs <topic> <section>
  * @typedef {object} DocsDetailSectionResponse
  * @property {'docs.detail.section'} type
  * @property {import('@astryxdesign/cli/authoring').ReferenceSection} data

package/api/hook/hook.type.d.mts

@@ -4,7 +4,7 @@
 export type HookDoc = import("@astryxdesign/cli/authoring").HookDoc;
 export type HookParamDoc = import("@astryxdesign/cli/authoring").HookParamDoc;
 /**
- * astryx --json hook [--list] [--category X] [--detail names|compact|full]
+ * xds --json hook [--list] [--category X] [--detail names|compact|full]
  *
  * The list view emits ONE `hook.list` type across all three detail levels; the
  * depth is carried in `data.detail` and `data.components` holds the grouped map
@@ -39,14 +39,14 @@ export type HookBriefEntry = {
     import: string;
 };
 /**
- * astryx --json hook <name>
+ * xds --json hook <name>
  */
 export type HookDetailResponse = {
     type: "hook.detail";
     data: HookDoc;
 };
 /**
- * astryx --json hook <name> --params
+ * xds --json hook <name> --params
  */
 export type HookDetailParamsResponse = {
     type: "hook.detail.params";

package/api/hook/hook.type.mjs

@@ -11,14 +11,14 @@
  *
  * Invocation                                 -> type discriminator
  * ------------------------------------------------------------------
- * astryx --json hook                         -> hook.list (data.detail='names')
- * astryx --json hook --list                  -> hook.list (data.detail='names')
- * astryx --json hook --category State        -> hook.list (filtered)
- * astryx --json hook --list --detail compact -> hook.list (data.detail='compact')
- * astryx --json hook --list --detail full    -> hook.list (data.detail='full')
- * astryx --json hook useMediaQuery           -> hook.detail
- * astryx --json hook useMediaQuery --params  -> hook.detail.params
- * (not found)                                -> CLIError
+ * xds --json hook                           -> hook.list (data.detail='names')
+ * xds --json hook --list                    -> hook.list (data.detail='names')
+ * xds --json hook --category State          -> hook.list (filtered)
+ * xds --json hook --list --detail compact   -> hook.list (data.detail='compact')
+ * xds --json hook --list --detail full      -> hook.list (data.detail='full')
+ * xds --json hook useMediaQuery             -> hook.detail
+ * xds --json hook useMediaQuery --params    -> hook.detail.params
+ * (not found)                               -> CLIError
  */
 
 // Re-export the authored-doc types from core so the hook leaves reference these
@@ -28,7 +28,7 @@
 /** @typedef {import('@astryxdesign/cli/authoring').HookParamDoc} HookParamDoc */
 
 /**
- * astryx --json hook [--list] [--category X] [--detail names|compact|full]
+ * xds --json hook [--list] [--category X] [--detail names|compact|full]
  *
  * The list view emits ONE `hook.list` type across all three detail levels; the
  * depth is carried in `data.detail` and `data.components` holds the grouped map
@@ -56,14 +56,14 @@
  */
 
 /**
- * astryx --json hook <name>
+ * xds --json hook <name>
  * @typedef {object} HookDetailResponse
  * @property {'hook.detail'} type
  * @property {HookDoc} data
  */
 
 /**
- * astryx --json hook <name> --params
+ * xds --json hook <name> --params
  * @typedef {object} HookDetailParamsResponse
  * @property {'hook.detail.params'} type
  * @property {HookParamDoc[]} data

package/api/search/search.type.d.mts

@@ -51,7 +51,7 @@ export type SearchResultEntry = {
     kind?: "page" | "block" | undefined;
 };
 /**
- * astryx --json search <query>
+ * xds --json search <query>
  */
 export type SearchResponse = {
     type: "search";

package/api/search/search.type.mjs

@@ -28,7 +28,7 @@
  */
 
 /**
- * astryx --json search <query>
+ * xds --json search <query>
  * @typedef {object} SearchResponse
  * @property {'search'} type
  * @property {object} data

package/api/swizzle/swizzle.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json swizzle [--list]
+ * xds --json swizzle [--list]
  */
 export type SwizzleListResponse = {
     type: "swizzle.list";
@@ -22,7 +22,7 @@ export type SwizzleFeedback = {
     ghCommand?: string | undefined;
 };
 /**
- * astryx --json swizzle <component>
+ * xds --json swizzle <component>
  */
 export type SwizzleCopyResponse = {
     type: "swizzle.copy";

package/api/swizzle/swizzle.type.mjs

@@ -7,7 +7,7 @@
  */
 
 /**
- * astryx --json swizzle [--list]
+ * xds --json swizzle [--list]
  *
  * @typedef {object} SwizzleListResponse
  * @property {'swizzle.list'} type
@@ -23,7 +23,7 @@
  */
 
 /**
- * astryx --json swizzle <component>
+ * xds --json swizzle <component>
  *
  * @typedef {object} SwizzleCopyResponse
  * @property {'swizzle.copy'} type

package/api/template/template.type.d.mts

@@ -2,7 +2,7 @@
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
 /**
- * astryx --json template [--list]
+ * xds --json template [--list]
  */
 export type TemplateListResponse = {
     type: "template.list";
@@ -53,7 +53,7 @@ export type TemplateListEntry = {
     scaffold?: boolean | undefined;
 };
 /**
- * astryx --json template <name>
+ * xds --json template <name>
  */
 export type TemplateShowResponse = {
     type: "template.show";
@@ -66,7 +66,7 @@ export type TemplateShowResponse = {
     };
 };
 /**
- * astryx --json template <name> --skeleton
+ * xds --json template <name> --skeleton
  */
 export type TemplateSkeletonResponse = {
     type: "template.skeleton";
@@ -78,7 +78,7 @@ export type TemplateSkeletonResponse = {
     };
 };
 /**
- * astryx --json template <name> [path]
+ * xds --json template <name> [path]
  */
 export type TemplateCopyResponse = {
     type: "template.copy";
@@ -90,7 +90,7 @@ export type TemplateCopyResponse = {
     };
 };
 /**
- * astryx --json template --cdn [path]
+ * xds --json template --cdn [path]
  * `written: false` with `reason: 'exists'` is a success: the command is safe to
  * re-run, and an edited page is the consumer's file to keep. `version` is the
  * Astryx version every CDN URL in the file was pinned to.

package/api/template/template.type.mjs

@@ -6,18 +6,18 @@
  *
  * Each template is exactly two files: page.tsx (code) + template.doc.mjs (metadata).
  *
- * Invocation                               -> type discriminator
+ * Invocation                                 -> type discriminator
  * ------------------------------------------------------------------
- * astryx --json template [--list]          -> template.list
- * astryx --json template <name>            -> template.show
- * astryx --json template <name> --skeleton -> template.skeleton
- * astryx --json template <name> [path]     -> template.copy
- * astryx --json template --cdn [path]      -> template.cdn
- * (unknown template)                       -> CLIError
+ * xds --json template [--list]              -> template.list
+ * xds --json template <name>               -> template.show
+ * xds --json template <name> --skeleton    -> template.skeleton
+ * xds --json template <name> [path]        -> template.copy
+ * xds --json template --cdn [path]         -> template.cdn
+ * (unknown template)                        -> CLIError
  */
 
 /**
- * astryx --json template [--list]
+ * xds --json template [--list]
  * @typedef {object} TemplateListResponse
  * @property {'template.list'} type
  * @property {TemplateListEntry[]} data
@@ -43,7 +43,7 @@
  */
 
 /**
- * astryx --json template <name>
+ * xds --json template <name>
  * @typedef {object} TemplateShowResponse
  * @property {'template.show'} type
  * @property {object} data
@@ -55,7 +55,7 @@
  */
 
 /**
- * astryx --json template <name> --skeleton
+ * xds --json template <name> --skeleton
  * @typedef {object} TemplateSkeletonResponse
  * @property {'template.skeleton'} type
  * @property {object} data
@@ -66,7 +66,7 @@
  */
 
 /**
- * astryx --json template <name> [path]
+ * xds --json template <name> [path]
  * @typedef {object} TemplateCopyResponse
  * @property {'template.copy'} type
  * @property {object} data
@@ -77,7 +77,7 @@
  */
 
 /**
- * astryx --json template --cdn [path]
+ * xds --json template --cdn [path]
  * `written: false` with `reason: 'exists'` is a success: the command is safe to
  * re-run, and an edited page is the consumer's file to keep. `version` is the
  * Astryx version every CDN URL in the file was pinned to.

package/api/theme/build/build.mjs

@@ -12,10 +12,9 @@
  * - A .d.ts (plus an optional .variants.d.ts for custom prop values)
  *
  * It performs the writes and returns a `theme.build` receipt — its `warnings`
- * carry override problems, every declaration core's generator dropped because
- * its value could not stay one CSS declaration, and any fonts the theme names
- * but does not load (font-warning.mjs) — or `null` when the theme produced no
- * CSS (nothing to build). Errors throw AstryxError (with
+ * carry override problems and any fonts the theme names but does not load
+ * (font-warning.mjs) — or `null` when the theme produced no CSS (nothing to
+ * build). Errors throw AstryxError (with
  * a stable code). Human progress is emitted through the shared `logger`
  * (silent by default), so the CLI keeps its exact output while a programmatic
  * caller stays quiet.
@@ -2304,15 +2303,7 @@ async function themeBuildInternal(
     const scopeSelector = themeScopeStart(themeDef.name);
     const scopeTo = THEME_SCOPE_TO;
 
-    // Older cores ignore this optional collector. Current core writes the same
-    // warning text here that runtime callers receive on the console.
-    /** @type {string[]} */
-    const droppedDeclarations = [];
-
-    const {component, prose} = _generateThemeRulesSplit(
-      resolvedTheme,
-      droppedDeclarations,
-    );
+    const {component, prose} = _generateThemeRulesSplit(resolvedTheme);
     const cssParts = [];
     // Prose element defaults always ship — the `<Theme>` runtime
     // (generateThemeCSS) always emits them, so the build must too, or the
@@ -2331,7 +2322,7 @@ async function themeBuildInternal(
     let adaptationCss;
     try {
       adaptationCss = _generateAdaptationCSS
-        ? _generateAdaptationCSS(resolvedTheme, droppedDeclarations)
+        ? _generateAdaptationCSS(resolvedTheme)
         : {component: '', prose: ''};
     } catch (error) {
       const message =
@@ -2377,16 +2368,11 @@ async function themeBuildInternal(
     // adaptations on the same resolved leaf.
     let onMediaCss = '';
     if (_generateOnMediaCSS) {
-      onMediaCss = _generateOnMediaCSS(resolvedTheme, droppedDeclarations);
+      onMediaCss = _generateOnMediaCSS(resolvedTheme);
       if (onMediaCss) {
         cssParts.push(`@layer astryx-theme {\n${onMediaCss}\n}`);
       }
     }
-    for (const message of droppedDeclarations) {
-      const w = `Declaration ${message}. The generated CSS omits it; fix the value in the theme source.`;
-      warningMessages.push(w);
-      logger.warn(`  ⚠ ${w}`);
-    }
     if (cssParts.length === 0) {
       logger.log('No overrides found — nothing to build.');
       return null;