@astryxdesign/cli 0.6.3-canary.f22695a → 0.6.3

package/authoring/doctypes/base/type.ts

@@ -4,46 +4,6 @@
  * @file Shared leaf primitives used across the doc types.
  */
 
-/** Every authored documentation kind accepted by `parseDoc`. */
-export type AuthoredDocKind =
-  | 'component'
-  | 'function'
-  | 'generic'
-  | 'page'
-  | 'block'
-  | 'schema'
-  | 'command'
-  | 'enum'
-  | 'namespace';
-
-/** Visibility of an authored doc in a compiled audience-specific bundle. */
-export type DocAudience = 'public' | 'internal';
-
-/**
- * Optional canonical placement request. The compiler resolves `parent` as a
- * stable doc reference. `slot` selects one parent-owned slot, and `order`
- * provides deterministic sibling ordering inside that slot.
- */
-export interface DocPlacement {
-  parent: string;
-  slot?: string;
-  order?: number;
-}
-
-/**
- * Graph metadata shared by every authored doc kind. Reserved for the docs
- * graph, which is not built yet: nothing reads these fields, and a reference
- * topic that sets one fails to load.
- */
-export interface AuthoredDocGraphFields {
-  /** Requested canonical parent in the docs graph. Not read yet. */
-  placement?: DocPlacement;
-  /** Prior routes or names the docs graph will keep resolving. Not read yet. */
-  aliases?: string[];
-  /** Docs bundle audience; omit for public docs. Not read yet. */
-  audience?: DocAudience;
-}
-
 /**
  * Stable public identity for generated registry resources.
  *

package/authoring/doctypes/command/command.doc.mjs

@@ -135,9 +135,8 @@ export const doc = {
         },
         {
           name: 'options[].default',
-          type: 'string | boolean | string[]',
-          description:
-            'Default value: a string, a boolean, or a list of strings.',
+          type: 'string',
+          description: 'Default value as a string.',
         },
         {
           name: 'options[].cliOnly',

package/authoring/doctypes/command/parse.d.mts

@@ -1,7 +1,7 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('../types.js').CommandDoc} CommandDoc */
+/** @typedef {import('../types').CommandDoc} CommandDoc */
 /**
  * Validate an unknown value as a stamped command doc, or throw.
  *
@@ -10,4 +10,4 @@
  * @returns {CommandDoc}
  */
 export function parseCommand(input: unknown, label?: string): CommandDoc;
-export type CommandDoc = import("../types.js").CommandDoc;
+export type CommandDoc = import("../types").CommandDoc;

package/authoring/doctypes/command/parse.mjs

@@ -8,7 +8,7 @@
 import {CommandDocKindSchema} from '../_schema.mjs';
 import {formatZodError} from '../../_shared/errors.mjs';
 
-/** @typedef {import('../types.js').CommandDoc} CommandDoc */
+/** @typedef {import('../types').CommandDoc} CommandDoc */
 
 /**
  * Validate an unknown value as a stamped command doc, or throw.

package/authoring/doctypes/command/type.ts

@@ -9,8 +9,7 @@
  * `--help`. Colocated at `clients/cli/commands/<name>.doc.mjs`.
  */
 
-import type {AuthoredDocGraphFields} from '../base/type.js';
-import type {ReferenceContentBlock} from '../reference/type.js';
+import type {ReferenceContentBlock} from '../reference/type';
 
 /** A positional argument. `param` links it to a FunctionDoc param for its description. */
 export interface CommandArgDoc {
@@ -54,7 +53,7 @@ export interface CommandExampleDoc {
  *   /\*\* @type {import('@astryxdesign/cli/authoring').CommandDoc} \*\/
  *   export const doc = { type: 'command', name: 'search', fn: 'search', ... };
  */
-export interface CommandDoc extends AuthoredDocGraphFields {
+export interface CommandDoc {
   /** Doc-kind discriminant. */
   type?: 'command';
   /** Command path, e.g. 'search' | 'theme build'. */

package/authoring/doctypes/component/component.doc.mjs

@@ -56,7 +56,7 @@ export const doc = {
       name: 'keywords',
       type: 'string[]',
       description:
-        'Search keywords for CLI discovery: synonyms and related UI concepts from other design systems (MUI, Chakra, Radix, and others). Lowercase. Used by `astryx component <term>` fuzzy matching.',
+        'Search keywords for CLI discovery: synonyms and related UI concepts from other design systems (MUI, Chakra, Radix, shadcn). Lowercase. Used by `astryx component <term>` fuzzy matching.',
     },
     {
       name: 'hiddenComponents',
@@ -124,7 +124,8 @@ export const doc = {
       name: 'usage',
       type: 'UsageDoc',
       description:
-        'Component usage documentation: concise summary, best practices, component-specific accessibility requirements, and optional visual anatomy. Required on a component doc; optional on a sub-component doc (`subComponentOf`), which uses its description instead.',
+        'Component usage documentation: concise summary, best practices, component-specific accessibility requirements, and optional visual anatomy. (Optional on SubComponentDoc, where the sub-component description is used instead.)',
+      required: true,
       fields: [
         {
           name: 'usage.description',
@@ -241,10 +242,6 @@ export const docs = {
     },
   ],
   notes: [
-    {
-      type: 'prose',
-      text: "When it loads, a stamped component doc is checked as loosely as an unstamped one, so adding `type: 'component'` to an existing doc never breaks it: `displayName` may be missing, `category` may be any string, and `usage`, `theming`, `playground` and `examples` are not checked. Each entry in a group doc's `components` must have a `name`. Write to the type anyway; it is the contract.",
-    },
     {
       type: 'prose',
       text: 'ComponentDoc is a discriminated union of three shapes that all extend ComponentBaseDoc. Pick the variant by which key you set: `props` (single), `components` (multi), or `subComponentOf` (sub).',

package/authoring/doctypes/component/parse.d.mts

@@ -1,7 +1,7 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('../types.js').ComponentDoc} ComponentDoc */
+/** @typedef {import('../types').ComponentDoc} ComponentDoc */
 /**
  * Validate an unknown value as a stamped component doc, or throw.
  *
@@ -10,4 +10,4 @@
  * @returns {ComponentDoc}
  */
 export function parseComponent(input: unknown, label?: string): ComponentDoc;
-export type ComponentDoc = import("../types.js").ComponentDoc;
+export type ComponentDoc = import("../types").ComponentDoc;

package/authoring/doctypes/component/parse.mjs

@@ -8,7 +8,7 @@
 import {ComponentDocKindSchema} from '../_schema.mjs';
 import {formatZodError} from '../../_shared/errors.mjs';
 
-/** @typedef {import('../types.js').ComponentDoc} ComponentDoc */
+/** @typedef {import('../types').ComponentDoc} ComponentDoc */
 
 /**
  * Validate an unknown value as a stamped component doc, or throw.

package/authoring/doctypes/component/type.ts

@@ -5,7 +5,6 @@
  */
 
 import type {
-  AuthoredDocGraphFields,
   ComponentAccessibilityRequirement,
   ComponentAnatomyElement,
   ComponentBestPractice,
@@ -19,13 +18,13 @@ import type {
   HookReturnDoc,
   RegistryDocIdentity,
   UsageDoc,
-} from '../base/type.js';
+} from '../base/type';
 
 /**
  * Shared fields between single-component and multi-component docs.
  * Do not use this interface directly — use `ComponentDoc` (the union type).
  */
-export interface ComponentBaseDoc extends AuthoredDocGraphFields {
+export interface ComponentBaseDoc {
   /** Doc-kind discriminant for the stamped default-export format
    *  (`export default { type: 'component', ... }`). Optional: legacy
    *  `export const docs = {...}` docs omit it, and `parseDoc` falls back to
@@ -50,7 +49,7 @@ export interface ComponentBaseDoc extends AuthoredDocGraphFields {
   import?: string;
   /** Search keywords for CLI discovery. Terms a developer might type when
    *  looking for this component: synonyms, related UI concepts, and common
-   *  names from other design systems (MUI, Chakra, Radix, and others).
+   *  names from other design systems (MUI, Chakra, Radix, shadcn).
    *  Lowercase only. Used by `astryx component <term>` for fuzzy matching.
    *  e.g. `['accordion', 'expand', 'toggle', 'disclosure']` for Collapsible */
   keywords?: string[];

package/authoring/doctypes/enum/parse.d.mts

@@ -1,7 +1,7 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('../types.js').EnumDoc} EnumDoc */
+/** @typedef {import('../types').EnumDoc} EnumDoc */
 /**
  * Validate an unknown value as a stamped enum doc, or throw.
  *
@@ -10,4 +10,4 @@
  * @returns {EnumDoc}
  */
 export function parseEnum(input: unknown, label?: string): EnumDoc;
-export type EnumDoc = import("../types.js").EnumDoc;
+export type EnumDoc = import("../types").EnumDoc;

package/authoring/doctypes/enum/parse.mjs

@@ -8,7 +8,7 @@
 import {EnumDocKindSchema} from '../_schema.mjs';
 import {formatZodError} from '../../_shared/errors.mjs';
 
-/** @typedef {import('../types.js').EnumDoc} EnumDoc */
+/** @typedef {import('../types').EnumDoc} EnumDoc */
 
 /**
  * Validate an unknown value as a stamped enum doc, or throw.

package/authoring/doctypes/enum/type.ts

@@ -5,8 +5,6 @@
  * discriminants). Colocated next to the source of truth it documents.
  */
 
-import type {AuthoredDocGraphFields} from '../base/type.js';
-
 /** One member of an enumerated vocabulary. */
 export interface EnumMemberDoc {
   /** The literal value, e.g. 'ERR_UNKNOWN_TOPIC' | 'component.list'. */
@@ -23,7 +21,7 @@ export interface EnumMemberDoc {
  *   /\*\* @type {import('@astryxdesign/cli/authoring').EnumDoc} \*\/
  *   export const doc = { type: 'enum', name: 'error-codes', ... };
  */
-export interface EnumDoc extends AuthoredDocGraphFields {
+export interface EnumDoc {
   /** Doc-kind discriminant. */
   type?: 'enum';
   /** URL-safe identifier, used as the docs slug within its namespace. */

package/authoring/doctypes/function/function.doc.mjs

@@ -250,10 +250,6 @@ export const doc = {
     },
   ],
   notes: [
-    {
-      type: 'prose',
-      text: 'When it loads, a stamped function doc may leave out `displayName`, and its `usage` is not checked. Write to the type anyway; it is the contract.',
-    },
     {
       type: 'prose',
       text: "The `type` discriminant is 'function' for both flavors. Set `kind: 'hook'` or `kind: 'api'` to drive docsite sectioning; it is inferred from `importPath` when omitted.",

package/authoring/doctypes/function/parse.d.mts

@@ -1,7 +1,7 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('../types.js').FunctionDoc} FunctionDoc */
+/** @typedef {import('../types').FunctionDoc} FunctionDoc */
 /**
  * Validate an unknown value as a stamped function doc, or throw.
  *
@@ -10,4 +10,4 @@
  * @returns {FunctionDoc}
  */
 export function parseFunction(input: unknown, label?: string): FunctionDoc;
-export type FunctionDoc = import("../types.js").FunctionDoc;
+export type FunctionDoc = import("../types").FunctionDoc;

package/authoring/doctypes/function/parse.mjs

@@ -14,7 +14,7 @@
 
 import {parseHook} from '../hook/parse.mjs';
 
-/** @typedef {import('../types.js').FunctionDoc} FunctionDoc */
+/** @typedef {import('../types').FunctionDoc} FunctionDoc */
 
 /**
  * Validate an unknown value as a stamped function doc, or throw.

package/authoring/doctypes/function/type.ts

@@ -10,11 +10,7 @@
  * here — the function does not know it has a CLI.
  */
 
-import type {
-  AuthoredDocGraphFields,
-  HookParamDoc,
-  UsageDoc,
-} from '../base/type.js';
+import type {HookParamDoc, UsageDoc} from '../base/type';
 
 /**
  * A documented return. Hooks list named return fields (`name` set); CLI/API
@@ -49,7 +45,7 @@ export interface FunctionExampleDoc {
  *   /\*\* @type {import('@astryxdesign/cli/authoring').FunctionDoc} \*\/
  *   export const doc = { type: 'function', kind: 'api', name: 'search', ... };
  */
-export interface FunctionDoc extends AuthoredDocGraphFields {
+export interface FunctionDoc {
   /** Doc-kind discriminant (shared with hooks). */
   type?: 'function';
   /** Export name, e.g. 'search' | 'useMediaQuery'. */

package/authoring/doctypes/hook/hook.doc.mjs

@@ -200,10 +200,6 @@ export const docs = {
     },
   ],
   notes: [
-    {
-      type: 'prose',
-      text: 'When it loads, a hook doc may leave out `displayName`, and its `usage` is not checked. Write to the type anyway; it is the contract.',
-    },
     {
       type: 'prose',
       text: "A hook's discriminant is `type: 'function'`: HookDoc and FunctionDoc share the generalized function kind. HookDoc is the hook-flavored view: named `returns` fields and a required `usage` block.",

package/authoring/doctypes/hook/parse.d.mts

@@ -1,7 +1,7 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('../types.js').HookDoc} HookDoc */
+/** @typedef {import('../types').HookDoc} HookDoc */
 /**
  * Validate an unknown value as a stamped function/hook doc, or throw.
  *
@@ -10,4 +10,4 @@
  * @returns {HookDoc}
  */
 export function parseHook(input: unknown, label?: string): HookDoc;
-export type HookDoc = import("../types.js").HookDoc;
+export type HookDoc = import("../types").HookDoc;

package/authoring/doctypes/hook/parse.mjs

@@ -8,7 +8,7 @@
 import {FunctionDocKindSchema} from '../_schema.mjs';
 import {formatZodError} from '../../_shared/errors.mjs';
 
-/** @typedef {import('../types.js').HookDoc} HookDoc */
+/** @typedef {import('../types').HookDoc} HookDoc */
 
 /**
  * Validate an unknown value as a stamped function/hook doc, or throw.

package/authoring/doctypes/hook/type.ts

@@ -5,14 +5,13 @@
  */
 
 import type {
-  AuthoredDocGraphFields,
   ComponentAccessibilityRequirement,
   ComponentBestPractice,
   HookParamDoc,
   HookReturnDoc,
   RegistryDocIdentity,
   UsageDoc,
-} from '../base/type.js';
+} from '../base/type';
 
 /**
  * Documentation for a standalone hook's .doc.mjs file.
@@ -28,7 +27,7 @@ import type {
  *   /\*\* @type {import('@astryxdesign/cli/authoring').HookDoc} \*\/
  *   export const docs = { ... };
  */
-export interface HookDoc extends AuthoredDocGraphFields {
+export interface HookDoc {
   /** Doc-kind discriminant for the stamped default-export format
    *  (`export default { type: 'function', ... }`). Optional: legacy
    *  `export const docs = {...}` docs omit it. */

package/authoring/doctypes/legacy.d.mts

@@ -1,17 +1,15 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('./types.js').ComponentDoc} ComponentDoc */
-/** @typedef {import('./types.js').HookDoc} HookDoc */
-/** @typedef {import('./types.js').ReferenceDoc} ReferenceDoc */
+/** @typedef {import('./types').ComponentDoc} ComponentDoc */
+/** @typedef {import('./types').HookDoc} HookDoc */
 /**
  * Validate an unknown value as a legacy (unstamped) doc, or throw.
  *
  * @param {unknown} input
  * @param {string} [label]
- * @returns {ComponentDoc | HookDoc | ReferenceDoc}
+ * @returns {ComponentDoc | HookDoc}
  */
-export function parseLegacyDoc(input: unknown, label?: string): ComponentDoc | HookDoc | ReferenceDoc;
-export type ComponentDoc = import("./types.js").ComponentDoc;
-export type HookDoc = import("./types.js").HookDoc;
-export type ReferenceDoc = import("./types.js").ReferenceDoc;
+export function parseLegacyDoc(input: unknown, label?: string): ComponentDoc | HookDoc;
+export type ComponentDoc = import("./types").ComponentDoc;
+export type HookDoc = import("./types").HookDoc;

package/authoring/doctypes/legacy.mjs

@@ -10,21 +10,20 @@
 import {LegacyDocSchema} from './_schema.mjs';
 import {formatZodError} from '../_shared/errors.mjs';
 
-/** @typedef {import('./types.js').ComponentDoc} ComponentDoc */
-/** @typedef {import('./types.js').HookDoc} HookDoc */
-/** @typedef {import('./types.js').ReferenceDoc} ReferenceDoc */
+/** @typedef {import('./types').ComponentDoc} ComponentDoc */
+/** @typedef {import('./types').HookDoc} HookDoc */
 
 /**
  * Validate an unknown value as a legacy (unstamped) doc, or throw.
  *
  * @param {unknown} input
  * @param {string} [label]
- * @returns {ComponentDoc | HookDoc | ReferenceDoc}
+ * @returns {ComponentDoc | HookDoc}
  */
 export function parseLegacyDoc(input, label = 'doc') {
   const result = LegacyDocSchema.safeParse(input);
   if (!result.success) {
     throw new Error(formatZodError(label, result.error));
   }
-  return /** @type {ComponentDoc | HookDoc | ReferenceDoc} */ (result.data);
+  return /** @type {ComponentDoc | HookDoc} */ (result.data);
 }

package/authoring/doctypes/parse.d.mts

@@ -1,15 +1,14 @@
 // @generated by scripts/sync-api-types.mjs from the JSDoc in authoring/**/*.mjs.
 // DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
 
-/** @typedef {import('./types.js').ComponentDoc} ComponentDoc */
-/** @typedef {import('./types.js').HookDoc} HookDoc */
-/** @typedef {import('./types.js').FunctionDoc} FunctionDoc */
-/** @typedef {import('./types.js').ReferenceDoc} ReferenceDoc */
-/** @typedef {import('./types.js').TemplateDoc} TemplateDoc */
-/** @typedef {import('./types.js').SchemaDoc} SchemaDoc */
-/** @typedef {import('./types.js').CommandDoc} CommandDoc */
-/** @typedef {import('./types.js').EnumDoc} EnumDoc */
-/** @typedef {import('./types.js').NamespaceDoc} NamespaceDoc */
+/** @typedef {import('./types').ComponentDoc} ComponentDoc */
+/** @typedef {import('./types').HookDoc} HookDoc */
+/** @typedef {import('./types').FunctionDoc} FunctionDoc */
+/** @typedef {import('./types').ReferenceDoc} ReferenceDoc */
+/** @typedef {import('./types').TemplateDoc} TemplateDoc */
+/** @typedef {import('./types').SchemaDoc} SchemaDoc */
+/** @typedef {import('./types').CommandDoc} CommandDoc */
+/** @typedef {import('./types').EnumDoc} EnumDoc */
 /**
  * Validate an unknown loaded doc value into its typed shape, or throw.
  * Dispatches on the stamped `type`; unstamped docs fall back to
@@ -18,15 +17,14 @@
  *
  * @param {unknown} input
  * @param {string} [label]
- * @returns {ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc | NamespaceDoc}
+ * @returns {ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc}
  */
-export function parseDoc(input: unknown, label?: string): ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc | NamespaceDoc;
-export type ComponentDoc = import("./types.js").ComponentDoc;
-export type HookDoc = import("./types.js").HookDoc;
-export type FunctionDoc = import("./types.js").FunctionDoc;
-export type ReferenceDoc = import("./types.js").ReferenceDoc;
-export type TemplateDoc = import("./types.js").TemplateDoc;
-export type SchemaDoc = import("./types.js").SchemaDoc;
-export type CommandDoc = import("./types.js").CommandDoc;
-export type EnumDoc = import("./types.js").EnumDoc;
-export type NamespaceDoc = import("./types.js").NamespaceDoc;
+export function parseDoc(input: unknown, label?: string): ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc;
+export type ComponentDoc = import("./types").ComponentDoc;
+export type HookDoc = import("./types").HookDoc;
+export type FunctionDoc = import("./types").FunctionDoc;
+export type ReferenceDoc = import("./types").ReferenceDoc;
+export type TemplateDoc = import("./types").TemplateDoc;
+export type SchemaDoc = import("./types").SchemaDoc;
+export type CommandDoc = import("./types").CommandDoc;
+export type EnumDoc = import("./types").EnumDoc;

package/authoring/doctypes/parse.mjs

@@ -15,18 +15,16 @@ import {parseTemplate} from './template/parse.mjs';
 import {parseSchema} from './schema/parse.mjs';
 import {parseCommand} from './command/parse.mjs';
 import {parseEnum} from './enum/parse.mjs';
-import {parseNamespace} from './namespace/parse.mjs';
 import {parseLegacyDoc} from './legacy.mjs';
 
-/** @typedef {import('./types.js').ComponentDoc} ComponentDoc */
-/** @typedef {import('./types.js').HookDoc} HookDoc */
-/** @typedef {import('./types.js').FunctionDoc} FunctionDoc */
-/** @typedef {import('./types.js').ReferenceDoc} ReferenceDoc */
-/** @typedef {import('./types.js').TemplateDoc} TemplateDoc */
-/** @typedef {import('./types.js').SchemaDoc} SchemaDoc */
-/** @typedef {import('./types.js').CommandDoc} CommandDoc */
-/** @typedef {import('./types.js').EnumDoc} EnumDoc */
-/** @typedef {import('./types.js').NamespaceDoc} NamespaceDoc */
+/** @typedef {import('./types').ComponentDoc} ComponentDoc */
+/** @typedef {import('./types').HookDoc} HookDoc */
+/** @typedef {import('./types').FunctionDoc} FunctionDoc */
+/** @typedef {import('./types').ReferenceDoc} ReferenceDoc */
+/** @typedef {import('./types').TemplateDoc} TemplateDoc */
+/** @typedef {import('./types').SchemaDoc} SchemaDoc */
+/** @typedef {import('./types').CommandDoc} CommandDoc */
+/** @typedef {import('./types').EnumDoc} EnumDoc */
 
 /**
  * Validate an unknown loaded doc value into its typed shape, or throw.
@@ -36,7 +34,7 @@ import {parseLegacyDoc} from './legacy.mjs';
  *
  * @param {unknown} input
  * @param {string} [label]
- * @returns {ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc | NamespaceDoc}
+ * @returns {ComponentDoc | HookDoc | FunctionDoc | ReferenceDoc | TemplateDoc | SchemaDoc | CommandDoc | EnumDoc}
  */
 export function parseDoc(input, label = 'doc') {
   const type =
@@ -60,11 +58,7 @@ export function parseDoc(input, label = 'doc') {
       return parseCommand(input, label);
     case 'enum':
       return parseEnum(input, label);
-    case 'namespace':
-      return parseNamespace(input, label);
-    case undefined:
-      return parseLegacyDoc(input, label);
     default:
-      throw new Error(`${label} has unsupported type ${JSON.stringify(type)}.`);
+      return parseLegacyDoc(input, label);
   }
 }

package/authoring/doctypes/parse.test.mjs

@@ -25,18 +25,8 @@ const goodComponent = {
   displayName: 'Widget',
   description: 'A small widget.',
   props: [
-    {
-      name: 'label',
-      type: 'string',
-      description: 'Visible label.',
-      required: true,
-    },
-    {
-      name: 'size',
-      type: "'sm' | 'md'",
-      description: 'Control size.',
-      default: "'md'",
-    },
+    {name: 'label', type: 'string', description: 'Visible label.', required: true},
+    {name: 'size', type: "'sm' | 'md'", description: 'Control size.', default: "'md'"},
   ],
 };
 
@@ -45,9 +35,7 @@ const goodFunction = {
   name: 'useThing',
   displayName: 'useThing',
   description: 'A thing hook.',
-  params: [
-    {name: 'input', type: 'string', description: 'The input.', required: true},
-  ],
+  params: [{name: 'input', type: 'string', description: 'The input.', required: true}],
   returns: [{name: 'value', type: 'string', description: 'The result.'}],
 };
 
@@ -55,11 +43,7 @@ const goodGeneric = {
   type: 'generic',
   name: 'Theming',
   displayName: 'Theming',
-  title: 'Theming',
   description: 'How theming works.',
-  sections: [
-    {title: 'Overview', content: [{type: 'prose', text: 'Use a theme.'}]},
-  ],
 };
 
 /** Run parseDoc and return the thrown message (asserting it throws). */
@@ -117,34 +101,6 @@ describe('per-kind parsers (stamped format)', () => {
     expect(() => parseReference(goodGeneric)).not.toThrow();
   });
 
-  it('normalizes a migrated minimal generic doc to the public shape', () => {
-    expect(
-      parseReference({
-        type: 'generic',
-        name: 'Theming',
-        description: 'How theming works.',
-      }),
-    ).toMatchObject({
-      type: 'generic',
-      name: 'Theming',
-      title: 'Theming',
-      description: 'How theming works.',
-      sections: [],
-    });
-  });
-
-  it('rejects duplicate stable section IDs', () => {
-    expect(() =>
-      parseReference({
-        ...goodGeneric,
-        sections: [
-          {id: 'start', title: 'Start', content: []},
-          {id: 'start', title: 'Renamed start', content: []},
-        ],
-      }),
-    ).toThrow(/sections\.1\.id.*duplicate section id/u);
-  });
-
   it('keeps nested rich blobs loose (usage/theming/playground passthrough)', () => {
     expect(() =>
       parseComponent({
@@ -167,16 +123,6 @@ describe('per-kind parsers (stamped format)', () => {
     expect(parsed.parent).toBe('WidgetGroup');
     expect(parsed.relatedDocs).toEqual(['Gauge', 'useThing']);
   });
-
-  it('validates graph metadata on unstamped legacy docs', () => {
-    expect(() =>
-      parseDoc({name: 'Widget', props: [], placement: {parent: ''}}),
-    ).toThrow(/placement\.parent/u);
-    expect(() => parseDoc({name: 'Widget', props: [], aliases: [1]})).toThrow();
-    expect(() =>
-      parseDoc({name: 'Widget', props: [], audience: 'secret'}),
-    ).toThrow();
-  });
 });
 
 describe('parseDoc (load boundary, both formats)', () => {
@@ -229,24 +175,6 @@ describe('parseDoc (load boundary, both formats)', () => {
     expect(() => parseDoc(hook)).not.toThrow();
   });
 
-  it('accepts and validates the OLD loose reference-topic shape', () => {
-    const reference = {
-      name: 'theming',
-      title: 'Theming',
-      description: 'How theming works.',
-      sections: [
-        {id: 'start', title: 'Start', content: [{type: 'prose', text: 'Go.'}]},
-      ],
-    };
-    expect(parseDoc(reference)).toEqual(reference);
-    expect(() =>
-      parseDoc({
-        ...reference,
-        sections: [{title: 'Start', content: [{type: 'prose'}]}],
-      }),
-    ).toThrow();
-  });
-
   it('accepts BOTH parent and legacy subComponentOf', () => {
     const withParent = {name: 'A', parent: 'B', props: []};
     const withSubComponentOf = {
@@ -361,9 +289,7 @@ describe('loadComponentDoc (end-to-end load boundary)', () => {
         "  type: 'generic',",
         "  name: 'Theming',",
         "  displayName: 'Theming',",
-        "  title: 'Theming',",
         "  description: 'How theming works.',",
-        "  sections: [{title: 'Overview', content: [{type: 'prose', text: 'Use a theme.'}]}],",
         '};',
       ].join('\n'),
     );