@storyshelf/affected 0.7.0 → 0.8.0

package/dist/git.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/git.d.ts
 /** Upper bound on changed files before falling back to a full render. */
 declare const MAX_CHANGED_FILES = 10000;
 /** Prefix marking CLI-synthesized identities for checkouts without git. */
@@ -42,6 +41,5 @@ declare function gitHeadSha(cwd: string): string | null;
 declare function gitBranchName(cwd: string): string | null;
 /** Synthesize a unique local sha for checkouts without git. */
 declare function localSha(): string;
-//#endregion
 export { GitRepoStatus, LOCAL_BRANCH, LOCAL_SHA_PREFIX, MAX_CHANGED_FILES, changedFiles, gitBranchName, gitHeadSha, gitRepoStatus, isShallowRepo, localSha };
 //# sourceMappingURL=git.d.mts.map

package/dist/git.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { execFileSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
-//#region src/git.ts
+// src/git.ts
 /** Upper bound on changed files before falling back to a full render. */
 const MAX_CHANGED_FILES = 1e4;
 /** Prefix marking CLI-synthesized identities for checkouts without git. */
@@ -115,7 +115,6 @@ function gitBranchName(cwd) {
 function localSha() {
 	return `${LOCAL_SHA_PREFIX}${randomUUID().replaceAll("-", "").slice(0, 12)}`;
 }
-//#endregion
 export { LOCAL_BRANCH, LOCAL_SHA_PREFIX, MAX_CHANGED_FILES, changedFiles, gitBranchName, gitHeadSha, gitRepoStatus, isShallowRepo, localSha };
 
 //# sourceMappingURL=git.mjs.map

package/dist/index.d.mts

@@ -6,7 +6,6 @@ import { STATS_FILENAME, buildGraph, graphModulesFor, loadDepGraph, loadStoryImp
 import { matchesAnyGlob, traceAffected } from "./trace.mjs";
 import { StoryPartition, selectAffectedStories } from "./select.mjs";
 import { PackageUsage, TrackedPackage, extractPackageUsage } from "./usage.mjs";
-//#region src/index.d.ts
 /**
  * Compute the affected story set for an upload. Never throws: every failure
  * degrades to a full render with a machine-readable `fullReason`, so
@@ -15,6 +14,5 @@ import { PackageUsage, TrackedPackage, extractPackageUsage } from "./usage.mjs";
  * @param input - Repository root, build dir, revisions, and trace options.
  */
 declare function computeAffected(input: AffectedInput): Promise<AffectedResult>;
-//#endregion
 export { type AffectedInput, type AffectedResult, type DepGraph, type GitRepoStatus, LOCAL_BRANCH, LOCAL_SHA_PREFIX, MAX_CHANGED_FILES, type PackageUsage, STATS_FILENAME, type StoryLike, type StoryPartition, type TraceOptions, type TrackedPackage, buildGraph, changedFiles, computeAffected, extractPackageUsage, gitBranchName, gitHeadSha, gitRepoStatus, graphModulesFor, isShallowRepo, loadDepGraph, loadStoryImportPaths, localSha, matchesAnyGlob, normalizePath, selectAffectedStories, statsPathFor, traceAffected };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -6,7 +6,7 @@ import { STATS_FILENAME, buildGraph, graphModulesFor, loadDepGraph, loadStoryImp
 import { matchesAnyGlob, traceAffected } from "./trace.mjs";
 import { selectAffectedStories } from "./select.mjs";
 import { extractPackageUsage } from "./usage.mjs";
-//#region src/index.ts
+// src/index.ts
 /**
 * Compute the affected story set for an upload. Never throws: every failure
 * degrades to a full render with a machine-readable `fullReason`, so
@@ -70,7 +70,6 @@ async function computeSelective(input) {
 		return fullResult(changed, input.baseSha, reason);
 	}
 }
-//#endregion
 export { LOCAL_BRANCH, LOCAL_SHA_PREFIX, MAX_CHANGED_FILES, STATS_FILENAME, buildGraph, changedFiles, computeAffected, extractPackageUsage, gitBranchName, gitHeadSha, gitRepoStatus, graphModulesFor, isShallowRepo, loadDepGraph, loadStoryImportPaths, localSha, matchesAnyGlob, normalizePath, selectAffectedStories, statsPathFor, traceAffected };
 
 //# sourceMappingURL=index.mjs.map

package/dist/select.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { StoryLike } from "./types.mjs";
-//#region src/select.d.ts
 /** Stories split into render-now versus inherit-from-baseline sets. */
 interface StoryPartition<T> {
   /** Stories to capture in this build. */
@@ -19,6 +18,5 @@ interface StoryPartition<T> {
  * @param affectedImportPaths - Affected import paths, or `null` for full.
  */
 declare function selectAffectedStories<T extends StoryLike>(stories: readonly T[], affectedImportPaths: readonly string[] | null): StoryPartition<T>;
-//#endregion
 export { StoryPartition, selectAffectedStories };
 //# sourceMappingURL=select.d.mts.map

package/dist/select.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { normalizePath } from "./stats.mjs";
-//#region src/select.ts
+// src/select.ts
 /** Sort stories into render versus inherit buckets for an affected set. */
 function partitionByPath(stories, affected, render, inherit) {
 	for (const story of stories) {
@@ -38,7 +38,6 @@ function selectAffectedStories(stories, affectedImportPaths) {
 		inherit
 	};
 }
-//#endregion
 export { selectAffectedStories };
 
 //# sourceMappingURL=select.mjs.map

package/dist/stats.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DepGraph } from "./types.mjs";
-//#region src/stats.d.ts
 /** Basename of the Vite stats file emitted next to a built Storybook. */
 declare const STATS_FILENAME = "preview-stats.json";
 /** A single module entry in a stats file (Vite or Webpack shape). */
@@ -42,6 +41,5 @@ declare function statsPathFor(cwd: string, buildDir: string, override?: string):
 declare function loadStoryImportPaths(cwd: string, buildDir: string): Promise<string[]>;
 /** Find graph modules referring to repo-relative file `target`. */
 declare function graphModulesFor(graph: DepGraph, target: string): string[];
-//#endregion
 export { STATS_FILENAME, buildGraph, graphModulesFor, loadDepGraph, loadStoryImportPaths, normalizePath, statsPathFor };
 //# sourceMappingURL=stats.d.mts.map

package/dist/stats.mjs

@@ -1,9 +1,8 @@
-import "node:path";
+import { join, resolve } from "node:path";
 import "node:url";
 import.meta.url;
 import { readFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
-//#region src/stats.ts
+// src/stats.ts
 /** Basename of the Vite stats file emitted next to a built Storybook. */
 const STATS_FILENAME = "preview-stats.json";
 /** Candidate index files listing a built Storybook's stories. */
@@ -166,7 +165,6 @@ function graphModulesFor(graph, target) {
 	for (const file of Object.keys(graph.importedBy)) if (matchesFile(file, target) && !matched.includes(file)) matched.push(file);
 	return matched;
 }
-//#endregion
 export { STATS_FILENAME, buildGraph, graphModulesFor, loadDepGraph, loadStoryImportPaths, normalizePath, statsPathFor, stripQueryAndLoader };
 
 //# sourceMappingURL=stats.mjs.map

package/dist/stats.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stats.mjs","names":["record"],"sources":["../src/stats.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport type { DepGraph } from \"./types.ts\";\n\n/** Basename of the Vite stats file emitted next to a built Storybook. */\nexport const STATS_FILENAME = \"preview-stats.json\";\n\n/** Candidate index files listing a built Storybook's stories. */\nconst INDEX_CANDIDATES = [\"stories.json\", \"index.json\"];\n\n/** A single module entry in a stats file (Vite or Webpack shape). */\ninterface StatsModule {\n  id?: unknown;\n  name?: unknown;\n  identifier?: unknown;\n  imported?: unknown;\n  importedIds?: unknown;\n  dependencies?: unknown;\n  reasons?: unknown;\n}\n\ninterface StoryIndex {\n  entries?: Record<string, { importPath?: unknown }>;\n}\n\n/**\n * Strip bundler module-id decoration so sub-modules fold into their file:\n * webpack loader chains (`a-loader!b-loader??opts!./Button.vue`) keep only\n * the resource after the last `!`, and `?query` suffixes\n * (`Button.vue?vue&type=script`, `Card.svelte?svelte&type=style`) are dropped.\n */\nexport function stripQueryAndLoader(value: string): string {\n  const resource = value.slice(value.lastIndexOf(\"!\") + 1);\n  const queryStart = resource.indexOf(\"?\");\n  return queryStart === -1 ? resource : resource.slice(0, queryStart);\n}\n\n/** Normalize a stats path to a repo-relative posix form for comparison. */\nexport function normalizePath(value: string): string {\n  return stripQueryAndLoader(value)\n    .replaceAll(\"\\\\\", \"/\")\n    .replaceAll(/^\\.\\//gu, \"\")\n    .replaceAll(/^\\//gu, \"\");\n}\n\n/** True when stats module `candidate` refers to repo-relative file `target`. */\nfunction matchesFile(candidate: string, target: string): boolean {\n  if (candidate === target) {\n    return true;\n  }\n  return candidate.endsWith(`/${target}`);\n}\n\n/** Coerce an unknown stats value to a list of normalized paths. */\nfunction asPathList(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  const paths: string[] = [];\n  for (const entry of value) {\n    if (typeof entry === \"string\" && entry.length > 0) {\n      paths.push(normalizePath(entry));\n    }\n  }\n  return paths;\n}\n\n/** Read a non-empty string field from a stats module entry. */\nfunction stringField(entry: StatsModule, key: \"id\" | \"name\" | \"identifier\"): string | null {\n  const value = entry[key];\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\n/** Read the file a stats module entry refers to, if any. */\nfunction moduleFile(entry: StatsModule): string | null {\n  const raw =\n    stringField(entry, \"id\") ?? stringField(entry, \"name\") ?? stringField(entry, \"identifier\");\n  return raw === null ? null : normalizePath(raw);\n}\n\n/** Forward imports declared by a stats module entry, if any. */\nfunction moduleImports(entry: StatsModule): string[] {\n  return asPathList(entry.imported ?? entry.importedIds ?? entry.dependencies);\n}\n\n/** Dependent names declared via Webpack-style `reasons`, if any. */\nfunction moduleReasonNames(entry: StatsModule): string[] {\n  if (!Array.isArray(entry.reasons)) {\n    return [];\n  }\n  const names: string[] = [];\n  for (const reason of entry.reasons) {\n    if (typeof reason === \"object\" && reason !== null) {\n      const record = reason as Record<string, unknown>;\n      const name = record[\"moduleName\"] ?? record[\"module\"];\n      if (typeof name === \"string\" && name.length > 0) {\n        names.push(normalizePath(name));\n      }\n    }\n  }\n  return names;\n}\n\n/** Attach a record-shaped module entry to its name. */\nfunction entryWithName(name: string, value: unknown): StatsModule {\n  if (typeof value === \"object\" && value !== null) {\n    return { name, ...(value as StatsModule) };\n  }\n  return { name };\n}\n\n/** Extract module entries from a parsed stats document of unknown shape. */\nfunction moduleEntries(document: unknown): StatsModule[] {\n  if (typeof document !== \"object\" || document === null) {\n    return [];\n  }\n  const record = document as Record<string, unknown>;\n  const raw = record[\"modules\"];\n  if (Array.isArray(raw)) {\n    return raw.filter((entry): entry is StatsModule => typeof entry === \"object\");\n  }\n  if (typeof raw === \"object\" && raw !== null) {\n    return Object.entries(raw as Record<string, unknown>).map(([name, value]) =>\n      entryWithName(name, value),\n    );\n  }\n  return [];\n}\n\n/** Record one directed edge in the graph under construction. */\nfunction addEdge(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n  from: string,\n  to: string,\n): void {\n  if (from === to) {\n    return;\n  }\n  const forward = imports.get(from) ?? new Set<string>();\n  forward.add(to);\n  imports.set(from, forward);\n  const reverse = importedBy.get(to) ?? new Set<string>();\n  reverse.add(from);\n  importedBy.set(to, reverse);\n}\n\n/** Add one stats entry's edges to the graph under construction. */\nfunction addEntryEdges(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n  entry: StatsModule,\n): void {\n  const file = moduleFile(entry);\n  if (!file) {\n    return;\n  }\n  for (const imported of moduleImports(entry)) {\n    addEdge(imports, importedBy, file, imported);\n  }\n  for (const dependent of moduleReasonNames(entry)) {\n    addEdge(imports, importedBy, dependent, file);\n  }\n}\nfunction toGraph(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n): DepGraph {\n  return {\n    imports: Object.fromEntries([...imports].map(([file, set]) => [file, [...set].toSorted()])),\n    importedBy: Object.fromEntries(\n      [...importedBy].map(([file, set]) => [file, [...set].toSorted()]),\n    ),\n  };\n}\n\n/**\n * Build a bidirectional dependency graph from parsed stats modules.\n *\n * @param entries - Module entries from a Vite or Webpack stats document.\n * @returns Bidirectional graph, or `null` when no usable edges exist.\n */\nexport function buildGraph(entries: StatsModule[]): DepGraph | null {\n  const imports = new Map<string, Set<string>>();\n  const importedBy = new Map<string, Set<string>>();\n  for (const entry of entries) {\n    addEntryEdges(imports, importedBy, entry);\n  }\n  if (imports.size === 0) {\n    return null;\n  }\n  return toGraph(imports, importedBy);\n}\n\n/**\n * Load and parse a stats file into a dependency graph.\n *\n * @param statsPath - Absolute or cwd-relative path to the stats JSON file.\n * @returns Graph, or `null` when the file is missing or unrecognized.\n */\nexport async function loadDepGraph(statsPath: string): Promise<DepGraph | null> {\n  let raw: string;\n  try {\n    raw = await readFile(statsPath, \"utf8\");\n  } catch {\n    return null;\n  }\n  let document: unknown;\n  try {\n    document = JSON.parse(raw) as unknown;\n  } catch {\n    return null;\n  }\n  return buildGraph(moduleEntries(document));\n}\n\n/** Resolve the stats file path for a built Storybook directory. */\nexport function statsPathFor(cwd: string, buildDir: string, override?: string): string {\n  if (override) {\n    return resolve(cwd, override);\n  }\n  return join(resolve(cwd, buildDir), STATS_FILENAME);\n}\n\n/**\n * Load the deduplicated story import paths from a built Storybook's index.\n *\n * @param cwd - Repository root.\n * @param buildDir - Built Storybook directory.\n * @returns Normalized import paths; throws when no index is readable.\n */\nexport async function loadStoryImportPaths(cwd: string, buildDir: string): Promise<string[]> {\n  const root = resolve(cwd, buildDir);\n  const documents = await Promise.all(\n    INDEX_CANDIDATES.map(async (name) => {\n      try {\n        return JSON.parse(await readFile(join(root, name), \"utf8\")) as StoryIndex;\n      } catch {\n        return null;\n      }\n    }),\n  );\n  const found = documents.find((document) => document !== null);\n  if (!found?.entries) {\n    throw new Error(`No Storybook index found in ${root}`);\n  }\n  const paths = new Set<string>();\n  for (const entry of Object.values(found.entries)) {\n    if (typeof entry.importPath === \"string\" && entry.importPath.length > 0) {\n      paths.add(normalizePath(entry.importPath));\n    }\n  }\n  return [...paths].toSorted();\n}\n\n/** Find graph modules referring to repo-relative file `target`. */\nexport function graphModulesFor(graph: DepGraph, target: string): string[] {\n  const matched: string[] = [];\n  for (const file of Object.keys(graph.imports)) {\n    if (matchesFile(file, target)) {\n      matched.push(file);\n    }\n  }\n  for (const file of Object.keys(graph.importedBy)) {\n    if (matchesFile(file, target) && !matched.includes(file)) {\n      matched.push(file);\n    }\n  }\n  return matched;\n}\n"],"mappings":"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"}
+{"version":3,"file":"stats.mjs","names":["record"],"sources":["../src/stats.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport type { DepGraph } from \"./types.ts\";\n\n/** Basename of the Vite stats file emitted next to a built Storybook. */\nexport const STATS_FILENAME = \"preview-stats.json\";\n\n/** Candidate index files listing a built Storybook's stories. */\nconst INDEX_CANDIDATES = [\"stories.json\", \"index.json\"];\n\n/** A single module entry in a stats file (Vite or Webpack shape). */\ninterface StatsModule {\n  id?: unknown;\n  name?: unknown;\n  identifier?: unknown;\n  imported?: unknown;\n  importedIds?: unknown;\n  dependencies?: unknown;\n  reasons?: unknown;\n}\n\ninterface StoryIndex {\n  entries?: Record<string, { importPath?: unknown }>;\n}\n\n/**\n * Strip bundler module-id decoration so sub-modules fold into their file:\n * webpack loader chains (`a-loader!b-loader??opts!./Button.vue`) keep only\n * the resource after the last `!`, and `?query` suffixes\n * (`Button.vue?vue&type=script`, `Card.svelte?svelte&type=style`) are dropped.\n */\nexport function stripQueryAndLoader(value: string): string {\n  const resource = value.slice(value.lastIndexOf(\"!\") + 1);\n  const queryStart = resource.indexOf(\"?\");\n  return queryStart === -1 ? resource : resource.slice(0, queryStart);\n}\n\n/** Normalize a stats path to a repo-relative posix form for comparison. */\nexport function normalizePath(value: string): string {\n  return stripQueryAndLoader(value)\n    .replaceAll(\"\\\\\", \"/\")\n    .replaceAll(/^\\.\\//gu, \"\")\n    .replaceAll(/^\\//gu, \"\");\n}\n\n/** True when stats module `candidate` refers to repo-relative file `target`. */\nfunction matchesFile(candidate: string, target: string): boolean {\n  if (candidate === target) {\n    return true;\n  }\n  return candidate.endsWith(`/${target}`);\n}\n\n/** Coerce an unknown stats value to a list of normalized paths. */\nfunction asPathList(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  const paths: string[] = [];\n  for (const entry of value) {\n    if (typeof entry === \"string\" && entry.length > 0) {\n      paths.push(normalizePath(entry));\n    }\n  }\n  return paths;\n}\n\n/** Read a non-empty string field from a stats module entry. */\nfunction stringField(entry: StatsModule, key: \"id\" | \"name\" | \"identifier\"): string | null {\n  const value = entry[key];\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\n/** Read the file a stats module entry refers to, if any. */\nfunction moduleFile(entry: StatsModule): string | null {\n  const raw =\n    stringField(entry, \"id\") ?? stringField(entry, \"name\") ?? stringField(entry, \"identifier\");\n  return raw === null ? null : normalizePath(raw);\n}\n\n/** Forward imports declared by a stats module entry, if any. */\nfunction moduleImports(entry: StatsModule): string[] {\n  return asPathList(entry.imported ?? entry.importedIds ?? entry.dependencies);\n}\n\n/** Dependent names declared via Webpack-style `reasons`, if any. */\nfunction moduleReasonNames(entry: StatsModule): string[] {\n  if (!Array.isArray(entry.reasons)) {\n    return [];\n  }\n  const names: string[] = [];\n  for (const reason of entry.reasons) {\n    if (typeof reason === \"object\" && reason !== null) {\n      const record = reason as Record<string, unknown>;\n      const name = record[\"moduleName\"] ?? record[\"module\"];\n      if (typeof name === \"string\" && name.length > 0) {\n        names.push(normalizePath(name));\n      }\n    }\n  }\n  return names;\n}\n\n/** Attach a record-shaped module entry to its name. */\nfunction entryWithName(name: string, value: unknown): StatsModule {\n  if (typeof value === \"object\" && value !== null) {\n    return { name, ...(value as StatsModule) };\n  }\n  return { name };\n}\n\n/** Extract module entries from a parsed stats document of unknown shape. */\nfunction moduleEntries(document: unknown): StatsModule[] {\n  if (typeof document !== \"object\" || document === null) {\n    return [];\n  }\n  const record = document as Record<string, unknown>;\n  const raw = record[\"modules\"];\n  if (Array.isArray(raw)) {\n    return raw.filter((entry): entry is StatsModule => typeof entry === \"object\");\n  }\n  if (typeof raw === \"object\" && raw !== null) {\n    return Object.entries(raw as Record<string, unknown>).map(([name, value]) =>\n      entryWithName(name, value),\n    );\n  }\n  return [];\n}\n\n/** Record one directed edge in the graph under construction. */\nfunction addEdge(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n  from: string,\n  to: string,\n): void {\n  if (from === to) {\n    return;\n  }\n  const forward = imports.get(from) ?? new Set<string>();\n  forward.add(to);\n  imports.set(from, forward);\n  const reverse = importedBy.get(to) ?? new Set<string>();\n  reverse.add(from);\n  importedBy.set(to, reverse);\n}\n\n/** Add one stats entry's edges to the graph under construction. */\nfunction addEntryEdges(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n  entry: StatsModule,\n): void {\n  const file = moduleFile(entry);\n  if (!file) {\n    return;\n  }\n  for (const imported of moduleImports(entry)) {\n    addEdge(imports, importedBy, file, imported);\n  }\n  for (const dependent of moduleReasonNames(entry)) {\n    addEdge(imports, importedBy, dependent, file);\n  }\n}\nfunction toGraph(\n  imports: Map<string, Set<string>>,\n  importedBy: Map<string, Set<string>>,\n): DepGraph {\n  return {\n    imports: Object.fromEntries([...imports].map(([file, set]) => [file, [...set].toSorted()])),\n    importedBy: Object.fromEntries(\n      [...importedBy].map(([file, set]) => [file, [...set].toSorted()]),\n    ),\n  };\n}\n\n/**\n * Build a bidirectional dependency graph from parsed stats modules.\n *\n * @param entries - Module entries from a Vite or Webpack stats document.\n * @returns Bidirectional graph, or `null` when no usable edges exist.\n */\nexport function buildGraph(entries: StatsModule[]): DepGraph | null {\n  const imports = new Map<string, Set<string>>();\n  const importedBy = new Map<string, Set<string>>();\n  for (const entry of entries) {\n    addEntryEdges(imports, importedBy, entry);\n  }\n  if (imports.size === 0) {\n    return null;\n  }\n  return toGraph(imports, importedBy);\n}\n\n/**\n * Load and parse a stats file into a dependency graph.\n *\n * @param statsPath - Absolute or cwd-relative path to the stats JSON file.\n * @returns Graph, or `null` when the file is missing or unrecognized.\n */\nexport async function loadDepGraph(statsPath: string): Promise<DepGraph | null> {\n  let raw: string;\n  try {\n    raw = await readFile(statsPath, \"utf8\");\n  } catch {\n    return null;\n  }\n  let document: unknown;\n  try {\n    document = JSON.parse(raw) as unknown;\n  } catch {\n    return null;\n  }\n  return buildGraph(moduleEntries(document));\n}\n\n/** Resolve the stats file path for a built Storybook directory. */\nexport function statsPathFor(cwd: string, buildDir: string, override?: string): string {\n  if (override) {\n    return resolve(cwd, override);\n  }\n  return join(resolve(cwd, buildDir), STATS_FILENAME);\n}\n\n/**\n * Load the deduplicated story import paths from a built Storybook's index.\n *\n * @param cwd - Repository root.\n * @param buildDir - Built Storybook directory.\n * @returns Normalized import paths; throws when no index is readable.\n */\nexport async function loadStoryImportPaths(cwd: string, buildDir: string): Promise<string[]> {\n  const root = resolve(cwd, buildDir);\n  const documents = await Promise.all(\n    INDEX_CANDIDATES.map(async (name) => {\n      try {\n        return JSON.parse(await readFile(join(root, name), \"utf8\")) as StoryIndex;\n      } catch {\n        return null;\n      }\n    }),\n  );\n  const found = documents.find((document) => document !== null);\n  if (!found?.entries) {\n    throw new Error(`No Storybook index found in ${root}`);\n  }\n  const paths = new Set<string>();\n  for (const entry of Object.values(found.entries)) {\n    if (typeof entry.importPath === \"string\" && entry.importPath.length > 0) {\n      paths.add(normalizePath(entry.importPath));\n    }\n  }\n  return [...paths].toSorted();\n}\n\n/** Find graph modules referring to repo-relative file `target`. */\nexport function graphModulesFor(graph: DepGraph, target: string): string[] {\n  const matched: string[] = [];\n  for (const file of Object.keys(graph.imports)) {\n    if (matchesFile(file, target)) {\n      matched.push(file);\n    }\n  }\n  for (const file of Object.keys(graph.importedBy)) {\n    if (matchesFile(file, target) && !matched.includes(file)) {\n      matched.push(file);\n    }\n  }\n  return matched;\n}\n"],"mappings":"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"}

package/dist/trace.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DepGraph, TraceOptions } from "./types.mjs";
-//#region src/trace.d.ts
 /** True when `path` matches any of the given glob patterns. */
 declare function matchesAnyGlob(path: string, patterns: readonly string[]): boolean;
 /**
@@ -14,6 +13,5 @@ declare function matchesAnyGlob(path: string, patterns: readonly string[]): bool
  * @returns Affected story files, or `null` when everything must render.
  */
 declare function traceAffected(graph: DepGraph, changedFiles: string[], storyFiles: readonly string[], options?: TraceOptions): string[] | null;
-//#endregion
 export { matchesAnyGlob, traceAffected };
 //# sourceMappingURL=trace.d.mts.map

package/dist/trace.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { graphModulesFor } from "./stats.mjs";
-//#region src/trace.ts
+// src/trace.ts
 /** Basenames whose change invalidates every story (global render setup). */
 const GLOBAL_BASENAMES = /* @__PURE__ */ new Set([
 	"preview.js",
@@ -160,7 +160,6 @@ function traceAffected(graph, changedFiles, storyFiles, options = {}) {
 	const storyOf = storyNodeMap(graph, storyFiles);
 	return [...reachableStories(graph, traceRoots(graph, relevant, storyOf), storyOf)].toSorted();
 }
-//#endregion
 export { matchesAnyGlob, traceAffected };
 
 //# sourceMappingURL=trace.mjs.map

package/dist/types.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/types.d.ts
 /**
  * Shared types for affected capture: dependency graphs, trace inputs, and
  * the affected-set result. Zero runtime dependencies by design — both the
@@ -52,6 +51,5 @@ interface AffectedResult {
 interface StoryLike {
   importPath?: string | null;
 }
-//#endregion
 export { AffectedInput, AffectedResult, DepGraph, StoryLike, TraceOptions };
 //# sourceMappingURL=types.d.mts.map

package/dist/usage.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DepGraph } from "./types.mjs";
-//#region src/usage.d.ts
 /** A dependency package a story file reaches, and the first module that reaches it. */
 interface PackageUsage {
   /** Story file (repo-relative, as given by the Storybook index). */
@@ -26,6 +25,5 @@ interface TrackedPackage {
  * @param packages - Packages to track (e.g. the project's declared dependencies).
  */
 declare function extractPackageUsage(graph: DepGraph, storyFiles: readonly string[], packages: Record<string, TrackedPackage>): PackageUsage[];
-//#endregion
 export { PackageUsage, TrackedPackage, extractPackageUsage };
 //# sourceMappingURL=usage.d.mts.map

package/dist/usage.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { graphModulesFor } from "./stats.mjs";
-//#region src/usage.ts
+// src/usage.ts
 const NODE_MODULES = "node_modules/";
 /** Package name for a `…/node_modules/<pkg>/…` module path, handling scopes. */
 function nodeModulesPackage(module) {
@@ -60,7 +60,6 @@ function extractPackageUsage(graph, storyFiles, packages) {
 	const tracked = new Map(Object.entries(packages));
 	return storyFiles.flatMap((storyFile) => usageForStory(graph, storyFile, graphModulesFor(graph, storyFile), tracked));
 }
-//#endregion
 export { extractPackageUsage };
 
 //# sourceMappingURL=usage.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storyshelf/affected",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Affected capture for StoryShelf: dependency-graph tracing that selects the stories impacted by a change.",
   "keywords": [
     "affected",
@@ -60,7 +60,7 @@
     "oxlint-tsgolint": "^7.0.2001",
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.5"
   },
   "engines": {
     "node": ">=24"