@discourser/design-system 0.15.0 → 0.17.0

package/dist/figma-codex/fixtures/CompoundComponent/index.d.ts

@@ -0,0 +1,2 @@
+export { Root, Header, Body, type RootProps } from './CompoundComponent';
+//# sourceMappingURL=index.d.ts.map

package/dist/figma-codex/fixtures/CompoundComponent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/figma-codex/fixtures/CompoundComponent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/figma-codex/fixtures/CompoundComponent.figma.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CompoundComponent.figma.d.ts.map

package/dist/figma-codex/fixtures/CompoundComponent.figma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompoundComponent.figma.d.ts","sourceRoot":"","sources":["../../../src/figma-codex/fixtures/CompoundComponent.figma.tsx"],"names":[],"mappings":""}

package/dist/figma-codex/fixtures/SimpleComponent.d.ts

@@ -0,0 +1,8 @@
+export interface SimpleComponentProps {
+    /** The display label */
+    label: string;
+    /** Optional size variant */
+    size?: 'sm' | 'md' | 'lg';
+}
+export declare const SimpleComponent: (props: SimpleComponentProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SimpleComponent.d.ts.map

package/dist/figma-codex/fixtures/SimpleComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleComponent.d.ts","sourceRoot":"","sources":["../../../src/figma-codex/fixtures/SimpleComponent.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,4CAE1D,CAAC"}

package/dist/figma-codex/fixtures/SimpleComponent.figma.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SimpleComponent.figma.d.ts.map

package/dist/figma-codex/fixtures/SimpleComponent.figma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleComponent.figma.d.ts","sourceRoot":"","sources":["../../../src/figma-codex/fixtures/SimpleComponent.figma.tsx"],"names":[],"mappings":""}

package/dist/figma-codex/generate.d.ts

@@ -0,0 +1,6 @@
+import { type FigmaCodexConfig } from './config';
+export interface GenerateOptions extends FigmaCodexConfig {
+    projectRoot?: string;
+}
+export declare function generate(options: GenerateOptions): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/figma-codex/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/figma-codex/generate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA0B7D,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAyDvD"}

package/dist/figma-codex/parser.d.ts

@@ -0,0 +1,18 @@
+export declare class ParseError extends Error {
+    readonly filePath: string;
+    constructor(message: string, filePath: string);
+}
+export interface ParsedFigmaFile {
+    filePath: string;
+    importStyle: 'named' | 'namespace';
+    componentName: string;
+    importSource: string;
+    connectSubComponent?: string;
+    figmaUrl: string;
+    figmaFileKey: string;
+    figmaNodeId: string;
+    example: string;
+    propsMapping: Record<string, string>;
+}
+export declare function parseFigmaFile(content: string, filePath: string): ParsedFigmaFile;
+//# sourceMappingURL=parser.d.ts.map

package/dist/figma-codex/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/figma-codex/parser.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aAGjB,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM;CAKnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,GAAG,WAAW,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AA0DD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,eAAe,CAuDjB"}

package/dist/figma-codex/resolver.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedFigmaFile } from './parser';
+import type { FigmaCodexConfig } from './config';
+import type { ComponentEntry } from './schema';
+export declare function resolveComponent(parsed: ParsedFigmaFile, config: FigmaCodexConfig): ComponentEntry;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/figma-codex/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/figma-codex/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,UAAU,CAAC;AAoMlB,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAwEhB"}

package/dist/figma-codex/schema.d.ts

@@ -0,0 +1,60 @@
+export interface FigmaCodex {
+    /** Schema version for forward compatibility */
+    version: '1.0.0';
+    /** Package name of the design system */
+    packageName: string;
+    /** ISO timestamp of generation */
+    generatedAt: string;
+    /** Git commit hash (if available) */
+    gitHash?: string;
+    /** Source Figma file(s) referenced */
+    figmaFiles: Record<string, {
+        fileKey: string;
+        fileName?: string;
+    }>;
+    /** The component registry */
+    components: Record<string, ComponentEntry>;
+}
+export interface ComponentEntry {
+    /** Human-readable component name */
+    name: string;
+    /** Component type classification */
+    type: 'simple' | 'compound' | 'composite';
+    /** Figma reference */
+    figma: {
+        fileKey: string;
+        nodeId: string;
+        nodeName?: string;
+        url: string;
+    };
+    /** Import information */
+    imports: {
+        /** Primary import statement */
+        primary: string;
+        /** Named exports available */
+        namedExports: string[];
+        /** Package subpath, e.g. '@discourser/design-system/Breadcrumb' */
+        subpath?: string;
+    };
+    /** Prop interface (extracted from TypeScript source) */
+    props: PropDefinition[];
+    /** Sub-components for compound components */
+    subComponents?: SubComponentEntry[];
+    /** Example JSX from .figma.tsx */
+    example: string;
+    /** Source file path relative to project root */
+    sourcePath: string;
+}
+export interface PropDefinition {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    defaultValue?: string;
+}
+export interface SubComponentEntry {
+    name: string;
+    element: string;
+    description?: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/figma-codex/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/figma-codex/schema.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CACF,CAAC;IAEF,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IAE1C,sBAAsB;IACtB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,yBAAyB;IACzB,OAAO,EAAE;QACP,+BAA+B;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,8BAA8B;QAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,wDAAwD;IACxD,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEpC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/figma-codex/writer.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentEntry } from './schema';
+interface WriteOptions {
+    packageName: string;
+    outputPath: string;
+}
+export declare function writeManifest(components: Record<string, ComponentEntry>, options: WriteOptions, projectRoot: string): void;
+export {};
+//# sourceMappingURL=writer.d.ts.map

package/dist/figma-codex/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/figma-codex/writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,UAAU,CAAC;AAE3D,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAC1C,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,GAClB,IAAI,CA0BN"}

package/dist/figma-codex.json

@@ -0,0 +1,373 @@
+{
+  "version": "1.0.0",
+  "packageName": "@discourser/design-system",
+  "generatedAt": "2026-02-27T23:54:31.947Z",
+  "gitHash": "7d3dad6e",
+  "figmaFiles": {
+    "GaHmFfmvO4loUzuZS4TgEz": {
+      "fileKey": "GaHmFfmvO4loUzuZS4TgEz"
+    }
+  },
+  "components": {
+    "Accordion": {
+      "name": "Accordion",
+      "type": "compound",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "38:8232",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=38-8232"
+      },
+      "imports": {
+        "primary": "import * as Accordion from '@discourser/design-system/Accordion'",
+        "namedExports": [
+          "Accordion.ItemBody"
+        ],
+        "subpath": "@discourser/design-system/Accordion"
+      },
+      "props": [],
+      "subComponents": [
+        {
+          "name": "ItemBody",
+          "element": "div"
+        }
+      ],
+      "example": "<Accordion.Root collapsible>\n        <Accordion.Item value=\"item-1\">\n          <Accordion.ItemTrigger>\n            <span>Trigger</span>\n            <Accordion.ItemIndicator />\n          </Accordion.ItemTrigger>\n          <Accordion.ItemContent>Content</Accordion.ItemContent>\n        </Accordion.Item>\n      </Accordion.Root>",
+      "sourcePath": "src/components/Accordion.tsx"
+    },
+    "Breadcrumb": {
+      "name": "Breadcrumb",
+      "type": "compound",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "38:7978",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=38-7978"
+      },
+      "imports": {
+        "primary": "import * as Breadcrumb from '@discourser/design-system/Breadcrumb'",
+        "namedExports": [
+          "Breadcrumb.Root",
+          "Breadcrumb.List",
+          "Breadcrumb.Item",
+          "Breadcrumb.Link",
+          "Breadcrumb.Ellipsis",
+          "Breadcrumb.Separator",
+          "Breadcrumb.CurrentLink"
+        ],
+        "subpath": "@discourser/design-system/Breadcrumb"
+      },
+      "props": [],
+      "subComponents": [
+        {
+          "name": "Root",
+          "element": "nav"
+        },
+        {
+          "name": "List",
+          "element": "ol"
+        },
+        {
+          "name": "Item",
+          "element": "li"
+        },
+        {
+          "name": "Link",
+          "element": "a"
+        },
+        {
+          "name": "Ellipsis",
+          "element": "li"
+        },
+        {
+          "name": "Separator",
+          "element": "li"
+        },
+        {
+          "name": "CurrentLink",
+          "element": "span"
+        }
+      ],
+      "example": "<Breadcrumb.Root>\n      <Breadcrumb.List>\n        <Breadcrumb.Item>\n          <Breadcrumb.Link href=\"#\">Home</Breadcrumb.Link>\n        </Breadcrumb.Item>\n        <Breadcrumb.Separator />\n        <Breadcrumb.Item>\n          <Breadcrumb.CurrentLink>Current</Breadcrumb.CurrentLink>\n        </Breadcrumb.Item>\n      </Breadcrumb.List>\n    </Breadcrumb.Root>",
+      "sourcePath": "src/components/Breadcrumb.tsx"
+    },
+    "ContentCard": {
+      "name": "ContentCard",
+      "type": "compound",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "478:5957",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=478-5957"
+      },
+      "imports": {
+        "primary": "import * as ContentCard from '@discourser/design-system/ContentCard'",
+        "namedExports": [
+          "ContentCard.Root",
+          "ContentCard.Header",
+          "ContentCard.Title",
+          "ContentCard.BadgeBar",
+          "ContentCard.Body",
+          "ContentCard.Section",
+          "ContentCard.SectionTitle",
+          "ContentCard.Separator",
+          "ContentCard.List",
+          "ContentCard.ListItem"
+        ],
+        "subpath": "@discourser/design-system/ContentCard"
+      },
+      "props": [],
+      "subComponents": [
+        {
+          "name": "Root",
+          "element": "div"
+        },
+        {
+          "name": "Header",
+          "element": "div"
+        },
+        {
+          "name": "Title",
+          "element": "h2"
+        },
+        {
+          "name": "BadgeBar",
+          "element": "div"
+        },
+        {
+          "name": "Body",
+          "element": "div"
+        },
+        {
+          "name": "Section",
+          "element": "section"
+        },
+        {
+          "name": "SectionTitle",
+          "element": "h3"
+        },
+        {
+          "name": "Separator",
+          "element": "hr"
+        },
+        {
+          "name": "List",
+          "element": "ul"
+        },
+        {
+          "name": "ListItem",
+          "element": "li"
+        }
+      ],
+      "example": "<ContentCard.Root>\n      <ContentCard.Header>\n        <ContentCard.Title>Title</ContentCard.Title>\n        <ContentCard.BadgeBar>badges</ContentCard.BadgeBar>\n      </ContentCard.Header>\n      <ContentCard.Body>Content</ContentCard.Body>\n      <ContentCard.Separator />\n      <ContentCard.Section>\n        <ContentCard.SectionTitle>Section</ContentCard.SectionTitle>\n        <ContentCard.List>\n          <ContentCard.ListItem>Item</ContentCard.ListItem>\n        </ContentCard.List>\n      </ContentCard.Section>\n    </ContentCard.Root>",
+      "sourcePath": "src/components/ContentCard/index.ts"
+    },
+    "Header": {
+      "name": "Header",
+      "type": "simple",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "485:4697",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=485-4697"
+      },
+      "imports": {
+        "primary": "import { Header } from '@discourser/design-system/Header'",
+        "namedExports": [
+          "Header"
+        ]
+      },
+      "props": [],
+      "example": "<Header size={size}>Heading Text</Header>",
+      "sourcePath": "src/components/Header.tsx"
+    },
+    "DiscourserLogo": {
+      "name": "DiscourserLogo",
+      "type": "simple",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "491:4933",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=491-4933"
+      },
+      "imports": {
+        "primary": "import { DiscourserLogo } from '@discourser/design-system/DiscourserLogo'",
+        "namedExports": [
+          "DiscourserLogo"
+        ]
+      },
+      "props": [],
+      "example": "<DiscourserLogo />",
+      "sourcePath": "src/components/Icons/DiscourserLogo.tsx"
+    },
+    "NavigationMenu": {
+      "name": "NavigationMenu",
+      "type": "composite",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "38:8485",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=38-8485"
+      },
+      "imports": {
+        "primary": "import { NavigationMenu } from '@discourser/design-system/NavigationMenu'",
+        "namedExports": [
+          "NavigationMenu"
+        ],
+        "subpath": "@discourser/design-system/NavigationMenu"
+      },
+      "props": [
+        {
+          "name": "sections",
+          "type": "NavSection[]",
+          "required": true
+        },
+        {
+          "name": "activeHref",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "defaultOpenSections",
+          "type": "string[]",
+          "required": false
+        },
+        {
+          "name": "onNavigate",
+          "type": "(href: string) => void",
+          "required": false
+        },
+        {
+          "name": "renderLink",
+          "type": "(props: { href: string; children: React.ReactNode; isActive: boolean; className: string; }) => React.ReactNode",
+          "required": false
+        },
+        {
+          "name": "ariaLabel",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "example": "<NavigationMenu\n        sections={[\n          {\n            value: 'dashboard',\n            title: 'Dashboard',\n            icon: null,\n            items: [\n              { label: 'Quick Start', href: '/dashboard/quick-start' },\n              { label: 'Progress', href: '/dashboard/progress' },\n            ],\n          },\n        ]}\n        defaultOpenSections={['dashboard']}\n        activeHref=\"/dashboard/quick-start\"\n      />",
+      "sourcePath": "src/components/NavigationMenu/NavigationMenu.tsx"
+    },
+    "ScenarioQueue": {
+      "name": "ScenarioQueue",
+      "type": "composite",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "478:5757",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=478-5757"
+      },
+      "imports": {
+        "primary": "import { ScenarioQueue } from '@discourser/design-system/ScenarioQueue'",
+        "namedExports": [
+          "ScenarioQueue"
+        ],
+        "subpath": "@discourser/design-system/ScenarioQueue"
+      },
+      "props": [
+        {
+          "name": "scenarios",
+          "type": "Scenario[]",
+          "required": true,
+          "description": "All scenarios — the component splits them by status internally"
+        },
+        {
+          "name": "onReorder",
+          "type": "(reorderedIds: string[]) => void",
+          "required": false,
+          "description": "Called when user reorders cards in the \"In Queue\" tab"
+        },
+        {
+          "name": "onRequeue",
+          "type": "(scenarioId: string) => void",
+          "required": false,
+          "description": "Called when user toggles a completed scenario back to the queue"
+        },
+        {
+          "name": "onRemove",
+          "type": "(scenarioId: string) => void",
+          "required": false,
+          "description": "Called when user removes a scenario from the queue"
+        },
+        {
+          "name": "renderAddScenarioContent",
+          "type": "(props: { onClose: () => void }) => ReactNode",
+          "required": false,
+          "description": "* Render prop / slot for the Add Scenario modal body. The design system provides the Dialog shell; the consumer (discourser.ai) provides the collection content. * Receives `onClose` to allow the consumer to close the modal after selection."
+        },
+        {
+          "name": "onBrowseMore",
+          "type": "() => void",
+          "required": false,
+          "description": "Called when user clicks \"Browse More Scenarios\" link inside the modal"
+        },
+        {
+          "name": "onBuildCustom",
+          "type": "() => void",
+          "required": false,
+          "description": "Called when user clicks \"Build Custom Scenario\" link inside the modal"
+        }
+      ],
+      "example": "<ScenarioQueue scenarios={scenarios} />",
+      "sourcePath": "src/components/ScenarioQueue/ScenarioQueue.tsx"
+    },
+    "ScenarioSettings": {
+      "name": "ScenarioSettings",
+      "type": "composite",
+      "figma": {
+        "fileKey": "GaHmFfmvO4loUzuZS4TgEz",
+        "nodeId": "38:8240",
+        "url": "https://www.figma.com/design/GaHmFfmvO4loUzuZS4TgEz/Discourser.AI--V1?node-id=38-8240"
+      },
+      "imports": {
+        "primary": "import { ScenarioSettings } from '@discourser/design-system/ScenarioSettings'",
+        "namedExports": [
+          "ScenarioSettings"
+        ],
+        "subpath": "@discourser/design-system/ScenarioSettings"
+      },
+      "props": [
+        {
+          "name": "defaultValue",
+          "type": "string[]",
+          "required": false,
+          "description": "* Section IDs that start expanded. Defaults to all six sections, or ['conversation-flow'] when singleOpen is true."
+        },
+        {
+          "name": "singleOpen",
+          "type": "boolean",
+          "required": false,
+          "description": "* When true, only one accordion section can be open at a time. @default false"
+        },
+        {
+          "name": "adjustmentDialogContent",
+          "type": "Partial<Record<AdjustableSectionId, ReactNode>>",
+          "required": false,
+          "description": "* ReactNode content to render inside each adjustable section's dialog. Keyed by section ID. Falls back to a placeholder when not provided."
+        },
+        {
+          "name": "renderAdjustmentDialog",
+          "type": "(sectionId: AdjustableSectionId) => ReactNode",
+          "required": false,
+          "description": "* Alternative render-function API for dialog content. Takes precedence over adjustmentDialogContent when both are provided."
+        },
+        {
+          "name": "defaultDuration",
+          "type": "DurationValue",
+          "required": false,
+          "description": "* Default selected value for the Duration radio group. @default 'quick'"
+        },
+        {
+          "name": "defaultQuestionCount",
+          "type": "QuestionCountValue",
+          "required": false,
+          "description": "* Default selected value for the Number of Questions radio group. @default 'brief'"
+        },
+        {
+          "name": "onSelectionChange",
+          "type": "(sectionId: RadioSectionId, value: string) => void",
+          "required": false,
+          "description": "* Called when a radio group selection changes. @param sectionId - 'duration' or 'number-of-questions' @param value - the selected radio value"
+        }
+      ],
+      "example": "<ScenarioSettings\n      defaultValue={['duration', 'number-of-questions']}\n      defaultDuration=\"standard\"\n      defaultQuestionCount=\"standard\"\n    />",
+      "sourcePath": "src/components/ScenarioSettings/index.ts"
+    }
+  }
+}