@astryxdesign/cli 0.6.3-canary.db4e378 → 0.6.3-canary.dea6813

package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.doc.mjs

@@ -1,14 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/** @type {import('@astryxdesign/cli/authoring').TemplateDoc} */
-export const doc = {
-  type: 'block',
-  exampleFor: 'ScrollableArea',
-  name: 'ScrollableArea — Sticky Passthrough',
-  displayName: 'Scrollable Area — Sticky Passthrough',
-  description:
-    'A section whose content fits clips instead of scrolling, so its sticky label passes outward and pins to the panel edge. The next section sets stickyContainment="always" and keeps its label in its own box.',
-  isReady: true,
-  aspectRatio: 1,
-  componentsUsed: ['ScrollableArea', 'Card', 'Grid'],
-};

package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaStickyPassthrough.tsx

@@ -1,122 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-'use client';
-
-import * as stylex from '@stylexjs/stylex';
-import {ScrollableArea} from '@astryxdesign/core/ScrollableArea';
-import {Card} from '@astryxdesign/core/Card';
-import {Grid} from '@astryxdesign/core/Grid';
-import {VStack} from '@astryxdesign/core/Layout';
-import {Heading, Text} from '@astryxdesign/core/Text';
-import {colorVars, spacingVars} from '@astryxdesign/core/theme/tokens.stylex';
-
-const styles = stylex.create({
-  sectionLabel: {
-    position: 'sticky',
-    insetBlockStart: 0,
-    zIndex: 1,
-    backgroundColor: colorVars['--color-background-card'],
-    paddingBlock: spacingVars['--spacing-2'],
-  },
-});
-
-const SHARED = [
-  {id: 'brand', title: 'Brand refresh', meta: 'Priya Raman'},
-  {id: 'checkout', title: 'Checkout audit', meta: 'Tomas Lindqvist'},
-  {id: 'partner', title: 'Partner deck', meta: 'Ines Okafor'},
-  {id: 'research', title: 'Research synthesis', meta: 'Mei Watanabe'},
-  {id: 'tax', title: 'Tax region notes', meta: 'Hugo Bernard'},
-  {id: 'sso', title: 'SSO rollout plan', meta: 'Sofia Marchetti'},
-];
-
-const TEMPLATES = [
-  {id: 'weekly', title: 'Weekly report', meta: 'Used 24 times'},
-  {id: 'checklist', title: 'Launch checklist', meta: 'Used 18 times'},
-  {id: 'review', title: 'Design review', meta: 'Used 11 times'},
-  {id: 'retro', title: 'Retro board', meta: 'Used 9 times'},
-  {id: 'brief', title: 'Project brief', meta: 'Used 7 times'},
-  {id: 'postmortem', title: 'Postmortem', meta: 'Used 4 times'},
-];
-
-const ARCHIVED = [
-  {id: 'roadmap', title: '2025 roadmap', meta: 'Archived in March'},
-  {id: 'legacy', title: 'Legacy pricing', meta: 'Archived in March'},
-  {id: 'kit', title: 'Old brand kit', meta: 'Archived in January'},
-  {id: 'beta', title: 'Beta feedback', meta: 'Archived in January'},
-  {id: 'survey', title: 'Q4 survey results', meta: 'Archived in January'},
-  {id: 'offsite', title: 'Offsite agenda', meta: 'Archived last year'},
-];
-
-function FileGrid({
-  files,
-}: {
-  files: Array<{id: string; title: string; meta: string}>;
-}) {
-  return (
-    <Grid columns={2} gap={2}>
-      {files.map(file => (
-        <Card key={file.id} variant="muted" padding={3}>
-          <VStack gap={1}>
-            <Text weight="medium" maxLines={1}>
-              {file.title}
-            </Text>
-            <Text type="supporting" maxLines={1}>
-              {file.meta}
-            </Text>
-          </VStack>
-        </Card>
-      ))}
-    </Grid>
-  );
-}
-
-export default function ScrollableAreaStickyPassthrough() {
-  return (
-    <Card width={400} padding={0}>
-      <ScrollableArea
-        axis="block"
-        role="region"
-        label="Workspace files"
-        height={300}
-        padding={4}>
-        <VStack gap={0.5} paddingBlockEnd={2}>
-          <Heading level={3}>Workspace files</Heading>
-          <Text type="supporting">18 files across 3 sections</Text>
-        </VStack>
-
-        {/* This section's content fits, so its viewport clips instead of
-            scrolling and never becomes the Sticky boundary: the label
-            passes outward and pins to the panel's edge. */}
-        <ScrollableArea axis="block" label="Shared with you">
-          <div {...stylex.props(styles.sectionLabel)}>
-            <Text type="label" color="secondary">
-              Shared with you
-            </Text>
-          </div>
-          <FileGrid files={SHARED} />
-        </ScrollableArea>
-
-        {/* Same fitting content, but containment is explicit: this viewport
-            stays the Sticky boundary, so its label leaves with the box. */}
-        <ScrollableArea
-          axis="block"
-          label="Templates"
-          stickyContainment="always">
-          <div {...stylex.props(styles.sectionLabel)}>
-            <Text type="label" color="secondary">
-              Templates
-            </Text>
-          </div>
-          <FileGrid files={TEMPLATES} />
-        </ScrollableArea>
-
-        <div {...stylex.props(styles.sectionLabel)}>
-          <Text type="label" color="secondary">
-            Archived
-          </Text>
-        </div>
-        <FileGrid files={ARCHIVED} />
-      </ScrollableArea>
-    </Card>
-  );
-}

package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.doc.mjs

@@ -1,14 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/** @type {import('@astryxdesign/cli/authoring').TemplateDoc} */
-export const doc = {
-  type: 'block',
-  exampleFor: 'ScrollableArea',
-  name: 'ScrollableArea — Two-Axis Board',
-  displayName: 'Scrollable Area — Two-Axis Board',
-  description:
-    'axis="both" gives the content box max-content inline sizing, so a board wider and taller than its panel scrolls on both axes from one viewport.',
-  isReady: true,
-  aspectRatio: 1,
-  componentsUsed: ['ScrollableArea', 'Card', 'Grid'],
-};

package/assets/templates/blocks/components/ScrollableArea/ScrollableAreaTwoAxisBoard.tsx

@@ -1,95 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-'use client';
-
-import {ScrollableArea} from '@astryxdesign/core/ScrollableArea';
-import {Card} from '@astryxdesign/core/Card';
-import {HStack, VStack} from '@astryxdesign/core/Layout';
-import {Heading, Text} from '@astryxdesign/core/Text';
-
-const COLUMNS = [
-  {
-    label: 'Recently opened',
-    files: [
-      {id: 'brief', title: 'Q3 launch brief', meta: 'Edited 2 days ago'},
-      {id: 'pricing', title: 'Pricing rework', meta: 'Edited 3 days ago'},
-      {
-        id: 'onboarding',
-        title: 'Onboarding flow v4',
-        meta: 'Edited 4 days ago',
-      },
-      {id: 'macros', title: 'Support macros', meta: 'Edited last week'},
-    ],
-  },
-  {
-    label: 'Shared with you',
-    files: [
-      {id: 'brand', title: 'Brand refresh', meta: 'Priya Raman'},
-      {id: 'checkout', title: 'Checkout audit', meta: 'Tomas Lindqvist'},
-      {id: 'partner', title: 'Partner deck', meta: 'Ines Okafor'},
-      {id: 'research', title: 'Research synthesis', meta: 'Mei Watanabe'},
-    ],
-  },
-  {
-    label: 'Templates',
-    files: [
-      {id: 'weekly', title: 'Weekly report', meta: 'Used 24 times'},
-      {id: 'checklist', title: 'Launch checklist', meta: 'Used 18 times'},
-      {id: 'review', title: 'Design review', meta: 'Used 11 times'},
-      {id: 'retro', title: 'Retro board', meta: 'Used 9 times'},
-    ],
-  },
-  {
-    label: 'Archived',
-    files: [
-      {id: 'roadmap', title: '2025 roadmap', meta: 'Archived in March'},
-      {id: 'legacy', title: 'Legacy pricing', meta: 'Archived in March'},
-      {id: 'kit', title: 'Old brand kit', meta: 'Archived in January'},
-      {id: 'beta', title: 'Beta feedback', meta: 'Archived in January'},
-    ],
-  },
-];
-
-export default function ScrollableAreaTwoAxisBoard() {
-  return (
-    <Card width={420} padding={0}>
-      {/* axis="both" gives the content box max-content inline sizing, so the
-          board is free to be wider than the viewport on both axes. The
-          heading is inside that box and travels with it. */}
-      <ScrollableArea
-        axis="both"
-        role="region"
-        label="Workspace board"
-        height={300}
-        padding={4}>
-        <VStack gap={4}>
-          <VStack gap={0.5}>
-            <Heading level={3}>Workspace board</Heading>
-            <Text type="supporting">16 files across 4 sections</Text>
-          </VStack>
-          <HStack gap={3} vAlign="start">
-            {COLUMNS.map(column => (
-              <VStack key={column.label} gap={2} width={180}>
-                <Text type="label" color="secondary">
-                  {column.label}
-                </Text>
-                {column.files.map(file => (
-                  <Card key={file.id} variant="muted" padding={3}>
-                    <VStack gap={1}>
-                      <Text weight="medium" maxLines={1}>
-                        {file.title}
-                      </Text>
-                      <Text type="supporting" maxLines={1}>
-                        {file.meta}
-                      </Text>
-                    </VStack>
-                  </Card>
-                ))}
-              </VStack>
-            ))}
-          </HStack>
-        </VStack>
-      </ScrollableArea>
-    </Card>
-  );
-}

package/foundation/response/response-types.doc.test.mjs

@@ -1,158 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file The response-types EnumDoc names every field of the responses below,
- * nested entry fields included. Fields come from real responses where one is
- * cheap to produce, else from the canonical typedef.
- */
-
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import {describe, it, expect} from 'vitest';
-import {doc} from './response-types.doc.mjs';
-import {runCli} from '../../test-utils/run-cli.mjs';
-
-/** @param {string} type */
-const describedAs = (type) => doc.members.find((m) => m.value === type)?.description ?? '';
-
-/** @param {string} text @param {string} field */
-const names = (text, field) => new RegExp(`(^|\\W)${field}(\\W|$)`).test(text);
-
-/**
- * Keys of an object, plus the keys of each nested object or array entry, `depth`
- * levels down.
- * @param {unknown} value @param {number} depth @returns {Set<string>}
- */
-function fieldsOf(value, depth = 2) {
-  const out = new Set();
-  const visit = (/** @type {unknown} */ v, /** @type {number} */ d) => {
-    if (Array.isArray(v)) return v.forEach((item) => visit(item, d));
-    if (!v || typeof v !== 'object' || d < 0) return;
-    for (const [key, child] of Object.entries(v)) {
-      out.add(key);
-      visit(child, d - 1);
-    }
-  };
-  visit(value, depth);
-  return out;
-}
-
-/** @param {string[]} args @param {string} [cwd] */
-async function data(args, cwd) {
-  const {status, stdout} = await runCli(['--json', ...args], cwd ? {cwd} : undefined);
-  expect(status, stdout).toBe(0);
-  return JSON.parse(stdout);
-}
-
-/** @param {string} type @param {Iterable<string>} fields */
-function expectNamed(type, fields) {
-  const text = describedAs(type);
-  const missing = [...fields].filter((f) => !names(text, f));
-  expect(missing, `${type} omits`).toEqual([]);
-}
-
-describe('response-types EnumDoc names every field', () => {
-  it('component.detail: the ownership fields and parentDoc', async () => {
-    const res = await data(['component', 'HStack']);
-    expect(res.type).toBe('component.detail');
-    const ownership = ['package', 'import', 'sourceAvailable', 'parentDoc'];
-    for (const f of ownership) expect(Object.keys(res.data)).toContain(f);
-    expectNamed('component.detail', ownership);
-    // The canonical response type declares parentDoc too.
-    const types = fs.readFileSync(
-      new URL('../../api/component/component.type.mjs', import.meta.url),
-      'utf8',
-    );
-    expect(types).toMatch(/@property \{string\} \[parentDoc\]/);
-  });
-
-  it('docs.index', async () => {
-    const res = await data(['docs', 'theme', '--index']);
-    expect(res.type).toBe('docs.index');
-    expectNamed('docs.index', fieldsOf(res.data));
-  });
-
-  it('search, across component, hook, template, and doc results', async () => {
-    const mixed = await data(['search', 'dashboard', '--limit', '50']);
-    const docsOnly = await data(['search', 'tokens', '--type', 'doc']);
-    expect(new Set(mixed.data.results.map((r) => r.domain))).toContain('template');
-    expectNamed('search', new Set([...fieldsOf(mixed.data), ...fieldsOf(docsOnly.data)]));
-  });
-
-  it('build.kit, including the hint a thin kit carries', async () => {
-    const res = await data(['build', 'zzqx-nothing-matches']);
-    expect(res.type).toBe('build.kit');
-    expect(res.data.hint).toBeDefined();
-    const fields = fieldsOf(res.data, 0);
-    for (const f of Object.keys(res.data.hint)) fields.add(f);
-    expectNamed('build.kit', fields);
-  });
-
-  it('theme.targets, including deprecatedFor', async () => {
-    const res = await data(['theme', 'targets']);
-    const fields = fieldsOf(res.data);
-    expect(fields).toContain('deprecatedFor');
-    expectNamed('theme.targets', fields);
-  });
-
-  it('gap-report.file, including each delivery', async () => {
-    const res = await data(['gap-report', 'Button', '--category', 'docs_gap', '--reason', 'probe']);
-    expect(res.type).toBe('gap-report.file');
-    expect(res.data.deliveries.length).toBeGreaterThan(0);
-    expectNamed('gap-report.file', fieldsOf(res.data));
-  });
-
-  it('theme.build, including notices', async () => {
-    const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-response-types-'));
-    fs.writeFileSync(path.join(cwd, 'package.json'), '{"name":"app","version":"1.0.0"}');
-    await data(['theme', 'template', 'starter.ts'], cwd);
-    const res = await data(['theme', 'build', 'starter.ts', '--out', 'starter.css'], cwd);
-    expect(res.type).toBe('theme.build');
-    expectNamed('theme.build', fieldsOf(res.data));
-  });
-
-  it('integration.pack-check (fields from api/integration/pack-check.type.mjs)', () => {
-    expectNamed('integration.pack-check', [
-      // PackCheckData
-      'name',
-      'version',
-      'packable',
-      'tarball',
-      'inventory',
-      'contributions',
-      'issues',
-      // PackCheckTarball
-      'filename',
-      'fileCount',
-      'size',
-      'unpackedSize',
-      // PackCheckInventory and PackCheckInventoryRoot
-      'manifest',
-      'roots',
-      'kind',
-      'path',
-      'expectedFiles',
-      'missingFiles',
-      'complete',
-      'packedFiles',
-      // contributions, each ContributionIdentities
-      'local',
-      'packed',
-      'themes',
-      'slug',
-      'exportName',
-      'components',
-      'templates',
-      'id',
-      'type',
-      'codemods',
-      'docs',
-      'agentDocsAppend',
-      // issues, each AstryxIntegrationIssue
-      'code',
-      'severity',
-      'message',
-    ]);
-  });
-});