@suss/contract-storybook 0.34.0 → 0.35.0

package/README.md

@@ -10,7 +10,9 @@ This package builds suss `BehavioralSummary[]` from [Storybook](https://storyboo
 
 The default export gives the component under test. The reader walks the declarations of the default export's symbol, looking for an object literal with a `component` property. That covers `export default { component: Button }`, `const meta = { component: Button }; export default meta;` and `export default { ... } satisfies Meta<typeof Button>`. Parentheses, `as` expressions, and an identifier that points at a local variable are followed through to the literal. A file whose default export never resolves to such an object is skipped, and the rest of the run continues.
 
-Every other named export whose initializer resolves to an object literal is a story. Its `args` object literal becomes the story's arguments, and each property's value is recorded as the source text you wrote. A shorthand property (`{ disabled }`) records its own name.
+The `component` identifier is followed through its import, any renames and any barrel re-exports, to the file that declares it. Each story file is read under the tsconfig nearest to it, so an import through one of its path aliases (`@ui/Chip/Chip`) resolves. The declaring file is written relative to the root an extract of that file's project measures from, with that project's workspace name, so the checker can find the extracted component by its own location. When the import leads to no file, for example because the module is generated or comes from a package that is not installed, no module is recorded, and the checker leaves the story unpaired.
+
+Every other named export whose initializer resolves to an object literal is a story. Its `args` object literal becomes the story's arguments, and each property's value is recorded as the source text you wrote. A shorthand property (`{ disabled }`) records its own name. Storybook gives every story the `args` set on the default export, so those are recorded on each story too, and a story's own arg replaces the meta's arg of the same name.
 
 ## What it produces
 
@@ -19,16 +21,16 @@ One `component`-kind summary per named story export:
 - `identity.name` is `Component.Story`, with `exportPath` set to the story's export name, and a function-call boundary binding with `transport: "in-process"`, `recognition: "react"`, and the component identifier as the export name.
 - One input per arg. The input's `role` is the arg name, and its shape is a `ref` whose name is the arg's source text, so a reader can see the value that was written.
 - One default transition whose output is a render of the component. The reader does not evaluate the render, so the rendered tree is left unset.
-- `metadata.component.storybook` with the story name, the component name, the args map, and `provenance: "independent"`. The provenance is what lets a story act as a check on an inferred component summary, since it was written separately from the component.
+- `metadata.component.storybook` with the story name, the component name, the component's module (`componentModule`, with `workspace`, `file` and `name`) and the specifier it is imported from (`componentImport`), the args map, `argReaders` when the story or its meta has `decorators` or a `render` function, `renderProps` with the props a render function passes the component as its own attributes or children, and `provenance: "independent"`. `renderProps` is left out when the render function renders the component through another element or spreads anything besides its args into it. A decorator or a render function receives the args before the component does, and the reader does not follow either, so the checker does not judge those args against the component. The provenance is what lets a story act as a check on an inferred component summary, since it was written separately from the component.
 - Confidence is `derived` at `medium`. People write stories, and a story is authoritative about what it covers, but stories do not list everything a component does.
 
 ## What it does not read
 
 - **`play` functions.** The sequence of events that drives an interactive story is not recorded.
 - **`argTypes`.** Control types and option lists per arg could support stricter type checking, but they are not read today.
-- **`decorators` and `parameters`.** These are Storybook runtime setup and do not describe the component's behavior.
+- **What `decorators`, `render` and `parameters` do.** Their presence is recorded, as above. A render function is read only for the attributes and children it gives the component's element, and the other bodies are not read. Decorators set in `.storybook/preview` apply to every story and are not seen at all.
 - **CSF1 and MDX stories.** CSF3 is the supported format.
-- **The component's own module.** The reader keeps the `component` identifier as written and does not follow the import to where the component is defined.
+- **A `component` that is not a plain identifier**, such as `Icons.Chip`. No module is recorded for it.
 - **Arg values as structured shapes.** An arg's value stays as source text inside a `ref` shape, and is not parsed into a `TypeShape`.
 
 ## Worked example

package/dist/index.cjs

@@ -37,39 +37,141 @@ var import_node_path = __toESM(require("path"), 1);
 var import_ts_morph = require("ts-morph");
 var import_adapter_typescript = require("@suss/adapter-typescript");
 var import_behavioral_ir = require("@suss/behavioral-ir");
+var import_files = require("@suss/behavioral-ir/files");
 function generateSummariesFromStories(filePaths, options = {}) {
-  const project = new import_ts_morph.Project({
-    skipAddingFilesFromTsConfig: true,
-    compilerOptions: {
-      target: 99,
-      module: 99,
-      moduleResolution: 100,
-      skipLibCheck: true,
-      allowJs: true,
-      jsx: 4
+  const componentModules = options.componentModules ?? true;
+  const byFile = /* @__PURE__ */ new Map();
+  const groups = componentModules ? filesByTsconfig(filePaths) : /* @__PURE__ */ new Map([[null, filePaths]]);
+  for (const [tsconfig, files] of groups) {
+    const project = projectFor(tsconfig);
+    const resolution = new import_adapter_typescript.ResolutionStore();
+    for (const sf of files.map((fp) => project.addSourceFileAtPath(fp))) {
+      const storyFile = sf.getFilePath();
+      const relPath = (0, import_files.pathInProject)(
+        storyFile,
+        options.projectRoot ?? (0, import_files.defaultProjectRoot)(storyFile)
+      );
+      const meta = extractMeta(sf, resolution, componentModules);
+      if (meta === null) {
+        continue;
+      }
+      byFile.set(
+        sf.getFilePath(),
+        extractStories(sf, resolution, meta).map(
+          (story) => buildSummary(story, meta, relPath)
+        )
+      );
     }
-  });
+  }
+  return filePaths.flatMap(
+    (fp) => byFile.get(import_node_path.default.resolve(fp).replace(/\\/g, "/")) ?? []
+  );
+}
+function filesByTsconfig(filePaths) {
+  const groups = /* @__PURE__ */ new Map();
   for (const fp of filePaths) {
-    project.addSourceFileAtPath(fp);
-  }
-  const projectRoot = options.projectRoot ?? process.cwd();
-  const summaries = [];
-  const resolution = new import_adapter_typescript.ResolutionStore();
-  for (const sf of project.getSourceFiles()) {
-    const absPath = sf.getFilePath();
-    const relPath = import_node_path.default.relative(projectRoot, absPath);
-    const meta = extractMeta(sf, resolution);
-    if (meta === null) {
+    const tsconfig = (0, import_adapter_typescript.findNearestTsconfig)(import_node_path.default.dirname(fp));
+    const group = groups.get(tsconfig) ?? [];
+    group.push(fp);
+    groups.set(tsconfig, group);
+  }
+  return groups;
+}
+var COMPILER_OPTIONS = {
+  target: 99,
+  module: 99,
+  moduleResolution: 100,
+  skipLibCheck: true,
+  allowJs: true,
+  jsx: 4,
+  // Ambient types say nothing about a story, and a missing types folder
+  // makes every program build fail.
+  types: []
+};
+function projectFor(tsconfig) {
+  if (tsconfig !== null) {
+    try {
+      return new import_ts_morph.Project({
+        tsConfigFilePath: tsconfig,
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: { allowJs: true, jsx: 4, types: [] }
+      });
+    } catch {
+    }
+  }
+  return new import_ts_morph.Project({
+    skipAddingFilesFromTsConfig: true,
+    compilerOptions: COMPILER_OPTIONS
+  });
+}
+var ARG_READERS = ["decorators", "render"];
+function argReadersOf(storyOrMeta, resolution) {
+  const names = new Set(
+    (0, import_adapter_typescript.propertiesOf)(storyOrMeta, resolution).map(
+      (property) => (0, import_adapter_typescript.propertyNameOf)(property)
+    )
+  );
+  return ARG_READERS.filter((name) => names.has(name));
+}
+function renderPropsOf(storyOrMeta, componentName, resolution) {
+  const property = (0, import_adapter_typescript.propertiesOf)(storyOrMeta, resolution).find(
+    (candidate) => (0, import_adapter_typescript.propertyNameOf)(candidate) === "render"
+  );
+  const render = property === void 0 ? null : (0, import_adapter_typescript.propertyFunctionOf)(property, resolution);
+  if (render === null) {
+    return null;
+  }
+  const argNames = argNamesOf(render.getParameters()[0]);
+  const elements = [
+    ...render.getDescendantsOfKind(import_ts_morph.SyntaxKind.JsxOpeningElement),
+    ...render.getDescendantsOfKind(import_ts_morph.SyntaxKind.JsxSelfClosingElement)
+  ].filter((element) => element.getTagNameNode().getText() === componentName);
+  if (elements.length === 0) {
+    return null;
+  }
+  const passed = /* @__PURE__ */ new Set();
+  if (elements.some(hasJsxChildren)) {
+    passed.add("children");
+  }
+  for (const attribute of elements.flatMap((e) => e.getAttributes())) {
+    if (import_ts_morph.Node.isJsxAttribute(attribute)) {
+      passed.add(attribute.getNameNode().getText());
       continue;
     }
-    const stories = extractStories(sf, resolution);
-    for (const story of stories) {
-      summaries.push(buildSummary(story, meta, relPath));
+    if (!argNames.has(attribute.getExpression().getText())) {
+      return null;
+    }
+  }
+  return [...passed].sort();
+}
+function hasJsxChildren(element) {
+  const parent = element.getParent();
+  if (!import_ts_morph.Node.isJsxOpeningElement(element) || !import_ts_morph.Node.isJsxElement(parent)) {
+    return false;
+  }
+  return parent.getJsxChildren().some(
+    (child) => !(import_ts_morph.Node.isJsxText(child) && child.containsOnlyTriviaWhiteSpaces())
+  );
+}
+function argNamesOf(parameter) {
+  const names = /* @__PURE__ */ new Set();
+  const nameNode = parameter?.getNameNode();
+  if (nameNode === void 0) {
+    return names;
+  }
+  if (import_ts_morph.Node.isIdentifier(nameNode)) {
+    names.add(nameNode.getText());
+    return names;
+  }
+  const elements = import_ts_morph.Node.isObjectBindingPattern(nameNode) ? nameNode.getDescendantsOfKind(import_ts_morph.SyntaxKind.BindingElement).filter((element) => element.getParent() === nameNode) : [];
+  for (const element of elements) {
+    if (element.getDotDotDotToken() !== void 0) {
+      names.add(element.getName());
     }
   }
-  return summaries;
+  return names;
 }
-function extractMeta(sf, resolution) {
+function extractMeta(sf, resolution, componentModules) {
   for (const exported of resolution.exportsOf(sf).get("default") ?? []) {
     const meta = objectBehind(exported, resolution);
     if (meta === null) {
@@ -77,16 +179,58 @@ function extractMeta(sf, resolution) {
     }
     const component = (0, import_adapter_typescript.propertyOf)(meta, "component", resolution);
     if (component !== null) {
-      return { componentName: component.getText() };
+      return {
+        componentName: component.getText(),
+        componentModule: componentModules ? declaredModuleOf(component) : void 0,
+        componentImport: importSpecifierOf(component),
+        args: argsOf(meta, resolution),
+        argReaders: argReadersOf(meta, resolution),
+        renderProps: renderPropsOf(meta, component.getText(), resolution)
+      };
     }
   }
   return null;
 }
+function declaredModuleOf(component) {
+  if (!import_ts_morph.Node.isIdentifier(component)) {
+    return void 0;
+  }
+  const declaration = componentDeclarationOf(component);
+  if (declaration === void 0) {
+    return void 0;
+  }
+  const place = (0, import_adapter_typescript.projectPlaceOf)(declaration.getSourceFile().getFilePath());
+  return {
+    ...place.workspace === null ? {} : { workspace: place.workspace },
+    file: place.file,
+    name: declaredNameOf(declaration) ?? component.getText()
+  };
+}
+function componentDeclarationOf(component) {
+  return (0, import_adapter_typescript.declarationsBehind)((0, import_adapter_typescript.symbolBehind)(component)).find(
+    (declaration) => !isImportBinding(declaration)
+  );
+}
+function isImportBinding(node) {
+  return import_ts_morph.Node.isImportSpecifier(node) || import_ts_morph.Node.isImportClause(node) || import_ts_morph.Node.isNamespaceImport(node) || import_ts_morph.Node.isImportEqualsDeclaration(node);
+}
+function declaredNameOf(declaration) {
+  if (import_ts_morph.Node.isVariableDeclaration(declaration) || import_ts_morph.Node.isFunctionDeclaration(declaration) || import_ts_morph.Node.isClassDeclaration(declaration)) {
+    return declaration.getName();
+  }
+  return void 0;
+}
+function importSpecifierOf(component) {
+  if (!import_ts_morph.Node.isIdentifier(component)) {
+    return void 0;
+  }
+  return (0, import_adapter_typescript.specifierImportedAs)(component.getSourceFile(), component.getText()) ?? void 0;
+}
 function objectBehind(value, resolution) {
   const resolved = resolution.resolveObject(value);
   return resolved !== null && import_ts_morph.Node.isObjectLiteralExpression(resolved) ? resolved : null;
 }
-function extractStories(sf, resolution) {
+function extractStories(sf, resolution, meta) {
   const results = [];
   for (const [name, decls] of (0, import_adapter_typescript.exportedDeclarationsOf)(sf, resolution)) {
     if (name === "default") {
@@ -97,18 +241,23 @@ function extractStories(sf, resolution) {
       if (story === null) {
         continue;
       }
+      const ownReaders = argReadersOf(story, resolution);
       results.push({
         name,
-        args: storyArgs(story, resolution),
+        args: { ...meta.args, ...argsOf(story, resolution) },
+        argReaders: ARG_READERS.filter(
+          (reader) => meta.argReaders.includes(reader) || ownReaders.includes(reader)
+        ),
+        renderProps: ownReaders.includes("render") ? renderPropsOf(story, meta.componentName, resolution) : meta.renderProps,
         line: decl.getStartLineNumber()
       });
     }
   }
   return results;
 }
-function storyArgs(story, resolution) {
+function argsOf(storyOrMeta, resolution) {
   const args = {};
-  const written = (0, import_adapter_typescript.propertyOf)(story, "args", resolution);
+  const written = (0, import_adapter_typescript.propertyOf)(storyOrMeta, "args", resolution);
   const object = written === null ? null : (0, import_adapter_typescript.objectLiteralOf)(written, resolution);
   if (object === null) {
     return args;
@@ -167,7 +316,11 @@ function buildSummary(story, meta, filePath) {
         storybook: {
           story: story.name,
           component: meta.componentName,
+          ...meta.componentModule === void 0 ? {} : { componentModule: meta.componentModule },
+          ...meta.componentImport === void 0 ? {} : { componentImport: meta.componentImport },
           args: story.args,
+          ...story.argReaders.length === 0 ? {} : { argReaders: story.argReaders },
+          ...story.renderProps === null ? {} : { renderProps: story.renderProps },
           provenance: "independent"
         }
       }

package/dist/index.d.cts

@@ -15,9 +15,16 @@ import { BehavioralSummary } from '@suss/behavioral-ir';
 interface StorybookStubOptions {
     /**
      * Each summary's `location.file` is relative to this, so it is the same
-     * on every machine. Defaults to the working directory.
+     * on every machine. Defaults to the repository each story is in.
      */
     projectRoot?: string;
+    /**
+     * False leaves out `componentModule`, the file each component is
+     * declared in. Finding it means reading the story under its tsconfig,
+     * whose path aliases make the type checker load most of the app, so a
+     * caller that only asks whether a file has stories passes false.
+     */
+    componentModules?: boolean;
 }
 /**
  * Reads `.stories.ts` and `.stories.tsx` files and returns one summary per

package/dist/index.d.ts

@@ -15,9 +15,16 @@ import { BehavioralSummary } from '@suss/behavioral-ir';
 interface StorybookStubOptions {
     /**
      * Each summary's `location.file` is relative to this, so it is the same
-     * on every machine. Defaults to the working directory.
+     * on every machine. Defaults to the repository each story is in.
      */
     projectRoot?: string;
+    /**
+     * False leaves out `componentModule`, the file each component is
+     * declared in. Finding it means reading the story under its tsconfig,
+     * whose path aliases make the type checker load most of the app, so a
+     * caller that only asks whether a file has stories passes false.
+     */
+    componentModules?: boolean;
 }
 /**
  * Reads `.stories.ts` and `.stories.tsx` files and returns one summary per

package/dist/index.js

@@ -2,52 +2,161 @@
 import path from "path";
 import {
   Node as N,
-  Project
+  Project,
+  SyntaxKind
 } from "ts-morph";
 import {
+  declarationsBehind,
   exportedDeclarationsOf,
+  findNearestTsconfig,
   objectLiteralOf,
+  projectPlaceOf,
   propertiesOf,
+  propertyFunctionOf,
   propertyNameOf,
   propertyOf,
   propertyValueOf,
   ResolutionStore,
-  stringValueOf
+  specifierImportedAs,
+  stringValueOf,
+  symbolBehind
 } from "@suss/adapter-typescript";
 import { functionCallBinding } from "@suss/behavioral-ir";
+import { defaultProjectRoot, pathInProject } from "@suss/behavioral-ir/files";
 function generateSummariesFromStories(filePaths, options = {}) {
-  const project = new Project({
-    skipAddingFilesFromTsConfig: true,
-    compilerOptions: {
-      target: 99,
-      module: 99,
-      moduleResolution: 100,
-      skipLibCheck: true,
-      allowJs: true,
-      jsx: 4
+  const componentModules = options.componentModules ?? true;
+  const byFile = /* @__PURE__ */ new Map();
+  const groups = componentModules ? filesByTsconfig(filePaths) : /* @__PURE__ */ new Map([[null, filePaths]]);
+  for (const [tsconfig, files] of groups) {
+    const project = projectFor(tsconfig);
+    const resolution = new ResolutionStore();
+    for (const sf of files.map((fp) => project.addSourceFileAtPath(fp))) {
+      const storyFile = sf.getFilePath();
+      const relPath = pathInProject(
+        storyFile,
+        options.projectRoot ?? defaultProjectRoot(storyFile)
+      );
+      const meta = extractMeta(sf, resolution, componentModules);
+      if (meta === null) {
+        continue;
+      }
+      byFile.set(
+        sf.getFilePath(),
+        extractStories(sf, resolution, meta).map(
+          (story) => buildSummary(story, meta, relPath)
+        )
+      );
     }
-  });
+  }
+  return filePaths.flatMap(
+    (fp) => byFile.get(path.resolve(fp).replace(/\\/g, "/")) ?? []
+  );
+}
+function filesByTsconfig(filePaths) {
+  const groups = /* @__PURE__ */ new Map();
   for (const fp of filePaths) {
-    project.addSourceFileAtPath(fp);
-  }
-  const projectRoot = options.projectRoot ?? process.cwd();
-  const summaries = [];
-  const resolution = new ResolutionStore();
-  for (const sf of project.getSourceFiles()) {
-    const absPath = sf.getFilePath();
-    const relPath = path.relative(projectRoot, absPath);
-    const meta = extractMeta(sf, resolution);
-    if (meta === null) {
+    const tsconfig = findNearestTsconfig(path.dirname(fp));
+    const group = groups.get(tsconfig) ?? [];
+    group.push(fp);
+    groups.set(tsconfig, group);
+  }
+  return groups;
+}
+var COMPILER_OPTIONS = {
+  target: 99,
+  module: 99,
+  moduleResolution: 100,
+  skipLibCheck: true,
+  allowJs: true,
+  jsx: 4,
+  // Ambient types say nothing about a story, and a missing types folder
+  // makes every program build fail.
+  types: []
+};
+function projectFor(tsconfig) {
+  if (tsconfig !== null) {
+    try {
+      return new Project({
+        tsConfigFilePath: tsconfig,
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: { allowJs: true, jsx: 4, types: [] }
+      });
+    } catch {
+    }
+  }
+  return new Project({
+    skipAddingFilesFromTsConfig: true,
+    compilerOptions: COMPILER_OPTIONS
+  });
+}
+var ARG_READERS = ["decorators", "render"];
+function argReadersOf(storyOrMeta, resolution) {
+  const names = new Set(
+    propertiesOf(storyOrMeta, resolution).map(
+      (property) => propertyNameOf(property)
+    )
+  );
+  return ARG_READERS.filter((name) => names.has(name));
+}
+function renderPropsOf(storyOrMeta, componentName, resolution) {
+  const property = propertiesOf(storyOrMeta, resolution).find(
+    (candidate) => propertyNameOf(candidate) === "render"
+  );
+  const render = property === void 0 ? null : propertyFunctionOf(property, resolution);
+  if (render === null) {
+    return null;
+  }
+  const argNames = argNamesOf(render.getParameters()[0]);
+  const elements = [
+    ...render.getDescendantsOfKind(SyntaxKind.JsxOpeningElement),
+    ...render.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)
+  ].filter((element) => element.getTagNameNode().getText() === componentName);
+  if (elements.length === 0) {
+    return null;
+  }
+  const passed = /* @__PURE__ */ new Set();
+  if (elements.some(hasJsxChildren)) {
+    passed.add("children");
+  }
+  for (const attribute of elements.flatMap((e) => e.getAttributes())) {
+    if (N.isJsxAttribute(attribute)) {
+      passed.add(attribute.getNameNode().getText());
       continue;
     }
-    const stories = extractStories(sf, resolution);
-    for (const story of stories) {
-      summaries.push(buildSummary(story, meta, relPath));
+    if (!argNames.has(attribute.getExpression().getText())) {
+      return null;
+    }
+  }
+  return [...passed].sort();
+}
+function hasJsxChildren(element) {
+  const parent = element.getParent();
+  if (!N.isJsxOpeningElement(element) || !N.isJsxElement(parent)) {
+    return false;
+  }
+  return parent.getJsxChildren().some(
+    (child) => !(N.isJsxText(child) && child.containsOnlyTriviaWhiteSpaces())
+  );
+}
+function argNamesOf(parameter) {
+  const names = /* @__PURE__ */ new Set();
+  const nameNode = parameter?.getNameNode();
+  if (nameNode === void 0) {
+    return names;
+  }
+  if (N.isIdentifier(nameNode)) {
+    names.add(nameNode.getText());
+    return names;
+  }
+  const elements = N.isObjectBindingPattern(nameNode) ? nameNode.getDescendantsOfKind(SyntaxKind.BindingElement).filter((element) => element.getParent() === nameNode) : [];
+  for (const element of elements) {
+    if (element.getDotDotDotToken() !== void 0) {
+      names.add(element.getName());
     }
   }
-  return summaries;
+  return names;
 }
-function extractMeta(sf, resolution) {
+function extractMeta(sf, resolution, componentModules) {
   for (const exported of resolution.exportsOf(sf).get("default") ?? []) {
     const meta = objectBehind(exported, resolution);
     if (meta === null) {
@@ -55,16 +164,58 @@ function extractMeta(sf, resolution) {
     }
     const component = propertyOf(meta, "component", resolution);
     if (component !== null) {
-      return { componentName: component.getText() };
+      return {
+        componentName: component.getText(),
+        componentModule: componentModules ? declaredModuleOf(component) : void 0,
+        componentImport: importSpecifierOf(component),
+        args: argsOf(meta, resolution),
+        argReaders: argReadersOf(meta, resolution),
+        renderProps: renderPropsOf(meta, component.getText(), resolution)
+      };
     }
   }
   return null;
 }
+function declaredModuleOf(component) {
+  if (!N.isIdentifier(component)) {
+    return void 0;
+  }
+  const declaration = componentDeclarationOf(component);
+  if (declaration === void 0) {
+    return void 0;
+  }
+  const place = projectPlaceOf(declaration.getSourceFile().getFilePath());
+  return {
+    ...place.workspace === null ? {} : { workspace: place.workspace },
+    file: place.file,
+    name: declaredNameOf(declaration) ?? component.getText()
+  };
+}
+function componentDeclarationOf(component) {
+  return declarationsBehind(symbolBehind(component)).find(
+    (declaration) => !isImportBinding(declaration)
+  );
+}
+function isImportBinding(node) {
+  return N.isImportSpecifier(node) || N.isImportClause(node) || N.isNamespaceImport(node) || N.isImportEqualsDeclaration(node);
+}
+function declaredNameOf(declaration) {
+  if (N.isVariableDeclaration(declaration) || N.isFunctionDeclaration(declaration) || N.isClassDeclaration(declaration)) {
+    return declaration.getName();
+  }
+  return void 0;
+}
+function importSpecifierOf(component) {
+  if (!N.isIdentifier(component)) {
+    return void 0;
+  }
+  return specifierImportedAs(component.getSourceFile(), component.getText()) ?? void 0;
+}
 function objectBehind(value, resolution) {
   const resolved = resolution.resolveObject(value);
   return resolved !== null && N.isObjectLiteralExpression(resolved) ? resolved : null;
 }
-function extractStories(sf, resolution) {
+function extractStories(sf, resolution, meta) {
   const results = [];
   for (const [name, decls] of exportedDeclarationsOf(sf, resolution)) {
     if (name === "default") {
@@ -75,18 +226,23 @@ function extractStories(sf, resolution) {
       if (story === null) {
         continue;
       }
+      const ownReaders = argReadersOf(story, resolution);
       results.push({
         name,
-        args: storyArgs(story, resolution),
+        args: { ...meta.args, ...argsOf(story, resolution) },
+        argReaders: ARG_READERS.filter(
+          (reader) => meta.argReaders.includes(reader) || ownReaders.includes(reader)
+        ),
+        renderProps: ownReaders.includes("render") ? renderPropsOf(story, meta.componentName, resolution) : meta.renderProps,
         line: decl.getStartLineNumber()
       });
     }
   }
   return results;
 }
-function storyArgs(story, resolution) {
+function argsOf(storyOrMeta, resolution) {
   const args = {};
-  const written = propertyOf(story, "args", resolution);
+  const written = propertyOf(storyOrMeta, "args", resolution);
   const object = written === null ? null : objectLiteralOf(written, resolution);
   if (object === null) {
     return args;
@@ -145,7 +301,11 @@ function buildSummary(story, meta, filePath) {
         storybook: {
           story: story.name,
           component: meta.componentName,
+          ...meta.componentModule === void 0 ? {} : { componentModule: meta.componentModule },
+          ...meta.componentImport === void 0 ? {} : { componentImport: meta.componentImport },
           args: story.args,
+          ...story.argReaders.length === 0 ? {} : { argReaders: story.argReaders },
+          ...story.renderProps === null ? {} : { renderProps: story.renderProps },
           provenance: "independent"
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/contract-storybook",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "type": "module",
   "description": "Turn Storybook CSF stories into a suss contract and check the props they pass against the React components that receive them.",
   "keywords": [
@@ -47,8 +47,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/adapter-typescript": "0.34.0",
-    "@suss/behavioral-ir": "0.34.0"
+    "@suss/adapter-typescript": "0.35.0",
+    "@suss/behavioral-ir": "0.35.0"
   },
   "devDependencies": {
     "tsup": "*",