@forgebook/react 0.0.0-stage → 0.1.0

package/dist/src/texts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The texts inside the stories for React components inside a story: the shown language's table, as the frame provides
+ * it, read with `useStoryText()`.
+ *
+ * @remarks
+ * The table and the text function are the format's (`@forgebook/story-format/texts`); this module is how a React
+ * component reads them. The frame's renderer provides the table (`reactRenderer.tsx`); outside a catalogue there is
+ * none, and a text is its key in brackets.
+ *
+ * @module
+ */
+import { type StoryTextFunction } from "@forgebook/story-format/texts";
+/** The texts of the shown language, as the catalogue's frame provides them; none outside a catalogue. */
+export declare const StoryTextsContext: import("react").Context<Readonly<Record<string, string>>>;
+/**
+ * The text function of the shown language, for a component inside a story.
+ *
+ * @returns `text(key, values?)`.
+ */
+export declare const useStoryText: () => StoryTextFunction;
+//# sourceMappingURL=texts.d.ts.map

package/dist/src/texts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texts.d.ts","sourceRoot":"","sources":["../../src/texts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAoC,MAAM,+BAA+B,CAAC;AAGzG,yGAAyG;AACzG,eAAO,MAAM,iBAAiB,2DAAoC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,iBAA+D,CAAC"}

package/dist/src/texts.js

@@ -0,0 +1,22 @@
+/**
+ * The texts inside the stories for React components inside a story: the shown language's table, as the frame provides
+ * it, read with `useStoryText()`.
+ *
+ * @remarks
+ * The table and the text function are the format's (`@forgebook/story-format/texts`); this module is how a React
+ * component reads them. The frame's renderer provides the table (`reactRenderer.tsx`); outside a catalogue there is
+ * none, and a text is its key in brackets.
+ *
+ * @module
+ */
+import { storyTextOf } from "@forgebook/story-format/texts";
+import { createContext, useContext } from "react";
+/** The texts of the shown language, as the catalogue's frame provides them; none outside a catalogue. */
+export const StoryTextsContext = createContext({});
+/**
+ * The text function of the shown language, for a component inside a story.
+ *
+ * @returns `text(key, values?)`.
+ */
+export const useStoryText = () => storyTextOf(useContext(StoryTextsContext));
+//# sourceMappingURL=texts.js.map

package/dist/src/texts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texts.js","sourceRoot":"","sources":["../../src/texts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA+C,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD,yGAAyG;AACzG,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAiB,EAAE,CAAC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAsB,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC"}

package/dist/src/vite/extractDocs.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentDocs, NoComponentDocs } from "forgebook/component-docs";
+import type { StoryComponentResult } from "forgebook/vite/adapter";
+/**
+ * The docs of a story file's component.
+ *
+ * @param storyFile - the story file's absolute path.
+ * @returns the component's docs, `{ name: null }` when the meta names no component, or a message saying why the file
+ * cannot be read.
+ */
+export declare const extractComponentDocs: (storyFile: string) => ComponentDocs | NoComponentDocs | string;
+/**
+ * A story file's component with the file that declares it.
+ *
+ * @param storyFile - the story file's absolute path.
+ * @returns the component, `{ docs: { name: null } }` when the meta names none, or a message saying why the file
+ * cannot be read.
+ */
+export declare const extractStoryComponent: (storyFile: string) => StoryComponentResult;
+//# sourceMappingURL=extractDocs.d.ts.map

package/dist/src/vite/extractDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractDocs.d.ts","sourceRoot":"","sources":["../../../src/vite/extractDocs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,aAAa,EAEb,eAAe,EAIhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAgXnE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,aAAa,GAAG,eAAe,GAAG,MAG1F,CAAC;AA8EF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,KAAG,oBAsCzD,CAAC"}

package/dist/src/vite/extractDocs.js

@@ -0,0 +1,439 @@
+/**
+ * The component of a React story file, read from its types and TSDoc: its props with their kind (the panel's group
+ * and control), its events' signatures and its parts. The docs module of `@forgebook/react`: the plugin's worker and
+ * `forgebook-docs` load it through the adapter (`forgebook/vite/adapter`).
+ *
+ * @remarks
+ * The component is the meta's `component`. Its props are the first parameter's properties declared in the package:
+ * what it passes on to the DOM (`ComponentProps<"button">`) comes from `node_modules` and is left out. Parts are the
+ * keys of the `classNames`, `styles` and `refs` maps (the reach-every-part rule).
+ *
+ * @module
+ */
+import { dirname } from "node:path";
+import { moduleSummaryOf, programFor, summaryOf, tagOf } from "forgebook/vite/docs-program";
+import { metaComponent, metaField } from "forgebook/vite/story-meta";
+import ts from "typescript-6";
+/** The props whose keys are the component's parts. */
+const PART_MAPS = ["classNames", "styles", "refs"];
+/** An event: a function prop named `on` and a capital. */
+const EVENT_NAME = /^on[A-Z]/;
+/**
+ * The subcomponents the meta names, in the order it writes them: `subcomponents: { ChipList, Items: MenuItem }`.
+ *
+ * @param source - the story file, parsed.
+ * @param checker - the program's checker.
+ */
+const metaSubcomponents = (source, checker) => {
+    const field = metaField(source, "subcomponents");
+    const object = field === undefined ? undefined : unwrapped(field);
+    if (object === undefined || !ts.isObjectLiteralExpression(object))
+        return [];
+    return object.properties.flatMap((property) => {
+        if (ts.isShorthandPropertyAssignment(property)) {
+            const symbol = checker.getShorthandAssignmentValueSymbol(property);
+            return [{ name: property.name.text, expression: property.name, symbol }];
+        }
+        if (!ts.isPropertyAssignment(property))
+            return [];
+        const name = ts.isIdentifier(property.name) || ts.isStringLiteral(property.name)
+            ? property.name.text
+            : property.name.getText(source);
+        const symbol = checker.getSymbolAtLocation(property.initializer);
+        return [{ name, expression: property.initializer, symbol }];
+    });
+};
+/** Whether a type is a union of string or number literals (a choice). */
+const literalValues = (type) => {
+    if (!type.isUnion())
+        return undefined;
+    const values = type.types.map((member) => member.isStringLiteral() || member.isNumberLiteral() ? member.value : undefined);
+    return values.every((value) => value !== undefined)
+        ? values.filter((value) => value !== undefined)
+        : undefined;
+};
+/** A literal value an expression writes (`"md"`, `3`, `-1`), or none for anything else. */
+const literalOfExpression = (expression) => {
+    if (ts.isStringLiteral(expression) || ts.isNoSubstitutionTemplateLiteral(expression))
+        return expression.text;
+    if (ts.isNumericLiteral(expression))
+        return Number(expression.text);
+    if (ts.isPrefixUnaryExpression(expression) &&
+        expression.operator === ts.SyntaxKind.MinusToken &&
+        ts.isNumericLiteral(expression.operand)) {
+        return -Number(expression.operand.text);
+    }
+    return undefined;
+};
+/** An expression without the wrappers around a literal list (`as const`, `satisfies`, parentheses). */
+const unwrapped = (expression) => {
+    let inner = expression;
+    while (ts.isAsExpression(inner) || ts.isSatisfiesExpression(inner) || ts.isParenthesizedExpression(inner)) {
+        inner = inner.expression;
+    }
+    return inner;
+};
+/** A symbol, through an import to what it names. */
+const declaredSymbol = (symbol, checker) => symbol !== undefined && symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
+/** The value a literal type node writes (`"md"`, `3`, `-1`), or none for another literal (`true`, `null`). */
+const literalTypeValue = (node) => {
+    const literal = node.literal;
+    const value = ts.isLiteralExpression(literal) || ts.isPrefixUnaryExpression(literal)
+        ? literalOfExpression(literal)
+        : undefined;
+    return value === undefined ? [] : [value];
+};
+/** The values a tuple query writes (`(typeof SIZES)[number]` with `SIZES = ["md", "sm"] as const`), in its order. */
+const tupleValues = (node, checker) => {
+    let object = node.objectType;
+    while (ts.isParenthesizedTypeNode(object))
+        object = object.type;
+    if (!ts.isTypeQueryNode(object))
+        return [];
+    const variable = declaredSymbol(checker.getSymbolAtLocation(object.exprName), checker)?.valueDeclaration;
+    if (variable === undefined || !ts.isVariableDeclaration(variable) || variable.initializer === undefined)
+        return [];
+    const list = unwrapped(variable.initializer);
+    if (!ts.isArrayLiteralExpression(list))
+        return [];
+    return list.elements.flatMap((element) => {
+        const value = literalOfExpression(element);
+        return value === undefined ? [] : [value];
+    });
+};
+/** The keys an object query writes (`keyof typeof TEXT_STYLES`), in the order the object writes them. */
+const keyValues = (node, checker) => {
+    if (node.operator !== ts.SyntaxKind.KeyOfKeyword || !ts.isTypeQueryNode(node.type))
+        return [];
+    const variable = declaredSymbol(checker.getSymbolAtLocation(node.type.exprName), checker)?.valueDeclaration;
+    if (variable === undefined || !ts.isVariableDeclaration(variable) || variable.initializer === undefined)
+        return [];
+    const object = unwrapped(variable.initializer);
+    if (!ts.isObjectLiteralExpression(object))
+        return [];
+    return object.properties.flatMap((property) => {
+        const name = property.name;
+        return name !== undefined && (ts.isIdentifier(name) || ts.isStringLiteral(name)) ? [name.text] : [];
+    });
+};
+/**
+ * The values an indexed type writes: a tuple's members (`(typeof SIZES)[number]`), or another type's prop as that
+ * type declares it (`PopoverProps["side"]`).
+ *
+ * @param node - the indexed type.
+ * @param checker - the type checker.
+ * @param seen - the nodes already walked.
+ */
+const accessedValues = (node, checker, seen) => {
+    const index = node.indexType;
+    if (!ts.isLiteralTypeNode(index) || !ts.isStringLiteral(index.literal))
+        return tupleValues(node, checker);
+    const prop = checker.getPropertyOfType(checker.getTypeFromTypeNode(node.objectType), index.literal.text);
+    return (prop?.declarations ?? []).flatMap((declaration) => ts.isPropertySignature(declaration) && declaration.type !== undefined
+        ? writtenLiterals(declaration.type, checker, seen)
+        : []);
+};
+/**
+ * The literal values a type node writes, in the order it writes them: through unions, aliases and a tuple's members.
+ *
+ * @param node - the type node.
+ * @param checker - the type checker, to follow a name to its declaration.
+ * @param seen - the nodes already walked, so a recursive alias ends.
+ */
+const writtenLiterals = (node, checker, seen) => {
+    if (seen.has(node))
+        return [];
+    seen.add(node);
+    if (ts.isParenthesizedTypeNode(node))
+        return writtenLiterals(node.type, checker, seen);
+    if (ts.isUnionTypeNode(node))
+        return node.types.flatMap((member) => writtenLiterals(member, checker, seen));
+    if (ts.isLiteralTypeNode(node))
+        return literalTypeValue(node);
+    if (ts.isIndexedAccessTypeNode(node))
+        return accessedValues(node, checker, seen);
+    if (ts.isTypeOperatorNode(node))
+        return keyValues(node, checker);
+    if (!ts.isTypeReferenceNode(node))
+        return [];
+    // a generic's arguments first (`Exclude<TableVariant, "changes">`): the values it keeps come from them
+    const fromArguments = (node.typeArguments ?? []).flatMap((argument) => writtenLiterals(argument, checker, seen));
+    const alias = declaredSymbol(checker.getSymbolAtLocation(node.typeName), checker)?.declarations?.find(ts.isTypeAliasDeclaration);
+    return [...fromArguments, ...(alias === undefined ? [] : writtenLiterals(alias.type, checker, seen))];
+};
+/**
+ * A choice's values in the order the source writes them: the checker's order follows the order it happened to meet
+ * the types in, which a program kept between reads changes from one read to the next.
+ *
+ * @param values - the values, in the checker's order.
+ * @param symbol - the prop.
+ * @param checker - the type checker.
+ * @returns the values, those the source writes in its order first, any other after them in the checker's order.
+ */
+const writtenOrder = (values, symbol, checker) => {
+    const seen = new Set();
+    const written = declaredTypesOf(symbol).flatMap((node) => ts.isMethodSignature(node) ? [] : writtenLiterals(node, checker, seen));
+    const rank = (value) => {
+        const index = written.indexOf(value);
+        return index === -1 ? written.length : index;
+    };
+    return [...values].sort((left, right) => rank(left) - rank(right));
+};
+/** A choice's type as TypeScript writes it, its members in the given order (`"md" | "sm"`). */
+const choiceTypeText = (values) => values.map((value) => (typeof value === "string" ? JSON.stringify(value) : String(value))).join(" | ");
+/**
+ * The props in the order the source declares them: those declared in the component's own folder first, then the
+ * ones it takes from elsewhere, each by file and position. The checker's order follows the types it met first (an
+ * `Omit`'s keys are a union), so a program kept between reads changed it from one read to the next.
+ *
+ * @param props - the props.
+ * @param componentFolder - the folder of the file that declares the component.
+ */
+const declarationOrder = (props, componentFolder) => {
+    const keyOf = (prop) => {
+        const [declaration] = prop.declarations ?? [];
+        if (declaration === undefined)
+            return [2, "", 0];
+        const file = declaration.getSourceFile().fileName;
+        return [dirname(file) === componentFolder ? 0 : 1, file, declaration.getStart()];
+    };
+    return [...props].sort((left, right) => {
+        const [leftOwn, leftFile, leftAt] = keyOf(left);
+        const [rightOwn, rightFile, rightAt] = keyOf(right);
+        return leftOwn - rightOwn || leftFile.localeCompare(rightFile) || leftAt - rightAt;
+    });
+};
+/** A type node's text as the source writes it, on one line. */
+const nodeText = (node) => node.getText().replace(/\s+/g, " ").trim();
+/**
+ * Whether a type node adds nothing a prop can take: `undefined` and `null` (left out as the checker's `NonNullable`
+ * did) and `never` (a branch of the props where the prop is not allowed).
+ */
+const isNothing = (node) => node.kind === ts.SyntaxKind.UndefinedKeyword ||
+    node.kind === ts.SyntaxKind.NeverKeyword ||
+    (ts.isLiteralTypeNode(node) && node.literal.kind === ts.SyntaxKind.NullKeyword);
+/** A type node without its parentheses. */
+const bareType = (node) => ts.isParenthesizedTypeNode(node) ? bareType(node.type) : node;
+/**
+ * A prop's declared type without what adds nothing (`undefined`, `null`, `never`): the members of a written union, or
+ * the node itself.
+ *
+ * @param node - the prop's declared type.
+ */
+const declaredMembers = (node) => {
+    const bare = bareType(node);
+    return (ts.isUnionTypeNode(bare) ? bare.types : [bare]).filter((member) => !isNothing(member));
+};
+/**
+ * A prop's declared type nodes: a property's type or a method's whole signature, once per declaration. A prop of
+ * props written as alternatives (`{ indicator?: never } | { indicator?: "dot" | "spinner" }`) has one per branch.
+ *
+ * @param symbol - the prop.
+ */
+const declaredTypesOf = (symbol) => (symbol.declarations ?? []).flatMap((declaration) => {
+    if (ts.isMethodSignature(declaration))
+        return [declaration];
+    return ts.isPropertySignature(declaration) && declaration.type !== undefined ? [declaration.type] : [];
+});
+/**
+ * A prop's type as the source writes it (`ReactNode`, `Ref<HTMLElement>`), without `undefined` and `null`: the
+ * checker's own text expands it and orders a union's members by the order it met the types in, which a program kept
+ * between reads changes from one read to the next.
+ *
+ * @param symbol - the prop.
+ * @returns the text, or none when the prop writes no type (the caller falls back to the checker's).
+ */
+const writtenTypeText = (symbol) => {
+    const texts = declaredTypesOf(symbol).flatMap((declared) => {
+        if (!ts.isMethodSignature(declared))
+            return declaredMembers(declared).map(nodeText);
+        const parameters = declared.parameters.map(nodeText).join(", ");
+        return [`(${parameters}) => ${declared.type === undefined ? "void" : nodeText(declared.type)}`];
+    });
+    // each branch's members once, in the order the branches write them
+    const unique = [...new Set(texts)];
+    return unique.length === 0 ? undefined : unique.join(" | ");
+};
+/**
+ * An event's signature as the source writes it: a function type among the prop's declared members, or a method.
+ *
+ * @param symbol - the event prop.
+ * @returns the signature, or none when the source writes none in place (a named handler type).
+ */
+const writtenSignature = (symbol) => {
+    const nodes = declaredTypesOf(symbol).flatMap((declared) => ts.isMethodSignature(declared) ? [declared] : declaredMembers(declared));
+    const fn = nodes.find((node) => ts.isMethodSignature(node) || ts.isFunctionTypeNode(node));
+    if (fn === undefined)
+        return undefined;
+    return {
+        parameters: fn.parameters.map((parameter) => ({
+            name: nodeText(parameter.name),
+            type: parameter.type === undefined ? "unknown" : nodeText(parameter.type)
+        })),
+        returns: fn.type === undefined ? "void" : nodeText(fn.type)
+    };
+};
+/** An event's signature. */
+const signatureOf = (type, checker, node) => {
+    const [signature] = type.getCallSignatures();
+    if (signature === undefined)
+        return undefined;
+    return {
+        parameters: signature.parameters.map((parameter) => ({
+            name: parameter.getName(),
+            type: checker.typeToString(checker.getTypeOfSymbolAtLocation(parameter, node))
+        })),
+        returns: checker.typeToString(signature.getReturnType())
+    };
+};
+/** A prop's kind, from its name and its type without `undefined`. */
+const kindOf = (name, type) => {
+    if (EVENT_NAME.test(name) && type.getCallSignatures().length > 0)
+        return "event";
+    if (type.flags & ts.TypeFlags.Boolean || type.flags & ts.TypeFlags.BooleanLiteral)
+        return "toggle";
+    if (literalValues(type) !== undefined)
+        return "choice";
+    if (type.flags & ts.TypeFlags.String)
+        return "text";
+    if (type.flags & ts.TypeFlags.Number)
+        return "number";
+    return "other";
+};
+/** Whether a symbol is declared outside the package (a DOM attribute from React's types). */
+const isForeign = (symbol) => (symbol.declarations ?? []).every((declaration) => declaration.getSourceFile().fileName.includes("/node_modules/"));
+/** One prop's docs. */
+const propDocs = (symbol, checker, node) => {
+    const type = checker.getNonNullableType(checker.getTypeOfSymbolAtLocation(symbol, node));
+    const name = symbol.getName();
+    const kind = kindOf(name, type);
+    const defaultValue = tagOf(symbol, checker, "defaultValue");
+    const checkerChoices = kind === "choice" ? literalValues(type) : undefined;
+    const choices = checkerChoices === undefined ? undefined : writtenOrder(checkerChoices, symbol, checker);
+    const signature = kind === "event" ? (writtenSignature(symbol) ?? signatureOf(type, checker, node)) : undefined;
+    // a node takes a text: the panel can set it as one, which covers labels, titles and children
+    const canTakeText = kind === "other" && checker.isTypeAssignableTo(checker.getStringType(), type);
+    return {
+        name,
+        kind,
+        type: choices === undefined
+            ? (writtenTypeText(symbol) ?? checker.typeToString(type))
+            : choiceTypeText(choices),
+        description: summaryOf(symbol, checker),
+        isRequired: (symbol.flags & ts.SymbolFlags.Optional) === 0,
+        ...(defaultValue === undefined ? {} : { defaultValue }),
+        ...(choices === undefined ? {} : { choices }),
+        ...(signature === undefined ? {} : { signature }),
+        ...(canTakeText ? { canTakeText } : {})
+    };
+};
+/**
+ * The docs of a story file's component.
+ *
+ * @param storyFile - the story file's absolute path.
+ * @returns the component's docs, `{ name: null }` when the meta names no component, or a message saying why the file
+ * cannot be read.
+ */
+export const extractComponentDocs = (storyFile) => {
+    const component = extractStoryComponent(storyFile);
+    return typeof component === "string" ? component : component.docs;
+};
+/**
+ * A component's props, read at the expression that names it.
+ *
+ * @param symbol - the component's symbol, through its import.
+ * @param expression - where the code names it.
+ * @param checker - the program's checker.
+ * @param storyFile - the story file, the folder when the component has no declaration.
+ */
+const componentProps = (symbol, expression, checker, storyFile) => {
+    const [signature] = checker.getTypeOfSymbolAtLocation(symbol, expression).getCallSignatures();
+    const propsSymbol = signature?.parameters[0];
+    const propsType = propsSymbol === undefined ? undefined : checker.getTypeOfSymbolAtLocation(propsSymbol, expression);
+    const ownProps = declarationOrder((propsType?.getProperties() ?? []).filter((prop) => !isForeign(prop)), dirname(symbol.declarations?.[0]?.getSourceFile().fileName ?? storyFile));
+    return { propsType, ownProps };
+};
+/**
+ * The files a component's docs come from: the one declaring it and those declaring its own props.
+ *
+ * @param symbol - the component's symbol.
+ * @param ownProps - its own props.
+ * @param storyFile - the story file, when the component has no declaration.
+ */
+const docsSources = (symbol, ownProps, storyFile) => [
+    symbol.declarations?.[0]?.getSourceFile().fileName ?? storyFile,
+    ...ownProps.flatMap((prop) => (prop.declarations ?? []).map((declaration) => declaration.getSourceFile().fileName))
+];
+/**
+ * The docs of the subcomponents a story file's meta names, with the files they come from.
+ *
+ * @param source - the story file, parsed.
+ * @param checker - the program's checker.
+ * @returns the docs and their files, or a message naming the subcomponent that cannot be resolved.
+ */
+const subcomponentsOf = (source, checker) => {
+    const docs = [];
+    const sources = [];
+    for (const subcomponent of metaSubcomponents(source, checker)) {
+        const symbol = declaredSymbol(subcomponent.symbol, checker);
+        if (symbol === undefined) {
+            return `${source.fileName}: the meta's subcomponent ${subcomponent.name} cannot be resolved`;
+        }
+        const { ownProps } = componentProps(symbol, subcomponent.expression, checker, source.fileName);
+        docs.push({
+            name: subcomponent.name,
+            description: summaryOf(symbol, checker),
+            props: ownProps.map((prop) => propDocs(prop, checker, subcomponent.expression))
+        });
+        sources.push(...docsSources(symbol, ownProps, source.fileName));
+    }
+    return { docs, sources };
+};
+/**
+ * A story file's component with the file that declares it.
+ *
+ * @param storyFile - the story file's absolute path.
+ * @returns the component, `{ docs: { name: null } }` when the meta names none, or a message saying why the file
+ * cannot be read.
+ */
+export const extractStoryComponent = (storyFile) => {
+    const program = programFor(storyFile);
+    if (typeof program === "string")
+        return program;
+    const { checker } = program;
+    const source = program.program.getSourceFile(storyFile);
+    if (source === undefined)
+        return `${storyFile} is not in its program`;
+    const expression = metaComponent(source);
+    if (expression === undefined)
+        return { docs: { name: null } };
+    const symbol = declaredSymbol(checker.getSymbolAtLocation(expression), checker);
+    if (symbol === undefined)
+        return `${storyFile}: the meta's component cannot be resolved`;
+    const subcomponents = subcomponentsOf(source, checker);
+    if (typeof subcomponents === "string")
+        return subcomponents;
+    const { propsType, ownProps } = componentProps(symbol, expression, checker, storyFile);
+    const props = ownProps.map((prop) => propDocs(prop, checker, expression));
+    const parts = [
+        ...new Set((propsType?.getProperties() ?? [])
+            .filter((prop) => PART_MAPS.includes(prop.getName()))
+            .flatMap((prop) => checker.getNonNullableType(checker.getTypeOfSymbolAtLocation(prop, expression)).getProperties())
+            .map((part) => part.getName()))
+    ];
+    const declarationFile = symbol.declarations?.[0]?.getSourceFile();
+    const sources = docsSources(symbol, ownProps, storyFile);
+    return {
+        docs: {
+            name: symbol.getName(),
+            description: summaryOf(symbol, checker),
+            summary: declarationFile === undefined ? "" : moduleSummaryOf(declarationFile),
+            props,
+            parts,
+            subcomponents: subcomponents.docs
+        },
+        file: sources[0] ?? storyFile,
+        sources: [...new Set([...sources, ...subcomponents.sources])]
+    };
+};
+//# sourceMappingURL=extractDocs.js.map

package/dist/src/vite/extractDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractDocs.js","sourceRoot":"","sources":["../../../src/vite/extractDocs.ts"],"names":[],"mappings":"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"}

package/dist/src/vite/react.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkAdapter } from "forgebook/vite/adapter";
+/**
+ * React, as the plugin reads its components: the docs module the docs' worker loads is this package's
+ * `extractDocs.ts` (the props from the first parameter's type, events as `on*` props); the generated pages draw with
+ * its renderer and write code with its JSX writer; Vite gets React's plugin.
+ *
+ * @returns the adapter.
+ */
+export declare const react: () => FrameworkAdapter;
+//# sourceMappingURL=react.d.ts.map

package/dist/src/vite/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/vite/react.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,QAAO,gBAkBvB,CAAC"}

package/dist/src/vite/react.js

@@ -0,0 +1,33 @@
+/**
+ * Forgebook's adapter for React, for the Vite plugin: `forgebookPlugin({ framework: react() })`.
+ *
+ * @module
+ */
+import { extname } from "node:path";
+/**
+ * React, as the plugin reads its components: the docs module the docs' worker loads is this package's
+ * `extractDocs.ts` (the props from the first parameter's type, events as `on*` props); the generated pages draw with
+ * its renderer and write code with its JSX writer; Vite gets React's plugin.
+ *
+ * @returns the adapter.
+ */
+export const react = () => ({
+    name: "react",
+    // beside this module, with its extension: `.ts` in the sources, `.js` once built for npm
+    docsModule: new URL(`./extractDocs${extname(import.meta.url)}`, import.meta.url).href,
+    pages: { frame: "@forgebook/react/frame", code: "@forgebook/react/code" },
+    // what the renderer and the JSX of the stories import in the frame (the server render for the generated tests)
+    browserDependencies: [
+        "react",
+        "react/jsx-runtime",
+        "react/jsx-dev-runtime",
+        "react-dom/client",
+        "react-dom/server"
+    ],
+    // Fast Refresh: an edited component updates in its frame and the story keeps its state
+    vitePlugins: async () => {
+        const { default: plugin } = await import("@vitejs/plugin-react");
+        return [plugin()];
+    }
+});
+//# sourceMappingURL=react.js.map

package/dist/src/vite/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/vite/react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAqB,EAAE,CAAC,CAAC;IAC5C,IAAI,EAAE,OAAO;IACb,yFAAyF;IACzF,UAAU,EAAE,IAAI,GAAG,CAAC,gBAAgB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI;IACrF,KAAK,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACzE,+GAA+G;IAC/G,mBAAmB,EAAE;QACnB,OAAO;QACP,mBAAmB;QACnB,uBAAuB;QACvB,kBAAkB;QAClB,kBAAkB;KACnB;IACD,uFAAuF;IACvF,WAAW,EAAE,KAAK,IAAsC,EAAE;QACxD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}